Skip to content
Back to search

akr

MCP server providing Akka.NET source intelligence for AI agents - 33 tools for type lookup, config reference, stream stages, and more. Zero config, dotnet tool.

Safety scan

A static text scan, not a guarantee. Select the badge to see what was scanned and every finding.

Badge for your README
findsafeskills safety rating

Markdown

[![findsafeskills safety rating](/api/listings/st0o0--akr/badge.svg)](/listings/st0o0--akr)

HTML

<a href="/listings/st0o0--akr"><img src="/api/listings/st0o0--akr/badge.svg" alt="findsafeskills safety rating" /></a>

Install

i

Install instructions from the README

As written by the repo's author. findsafeskills has not verified these steps.

1. Add to your project

dotnet tool install akr

This adds akr to your `.config/dotnet-tools.json`. Run `dotnet tool restore` on any machine to install it.

2. Add MCP config

Create `.mcp.json` in your repo root:

{
  "mcpServers": {
    "akr": {
      "command": "dotnet",
      "args": ["tool", "run", "akr"]
    }
  }
}

Your MCP client (Claude Code, VS Code, Cursor) discovers this automatically. Done.

Alternative: global install

dotnet tool install --global Akr

Then configure your MCP client with `"command": "akr"` directly.

What was scanned

The files the safety scan read, as written by the repository's author and shown as plain text. Lines with a finding are marked.

README.md · README · 151 lines
  1. # akr
  2. [![Release](https://img.shields.io/github/v/release/st0o0/akr?sort=semver&style=flat-square)](https://github.com/st0o0/akr/releases)
  3. [![NuGet](https://img.shields.io/nuget/v/Akr?style=flat-square)](https://www.nuget.org/packages/Akr)
  4. [![License: MIT](https://img.shields.io/badge/License-MIT-green.svg?style=flat-square)](LICENSE)
  5. Akka.NET source intelligence for AI agents. An [MCP](https://modelcontextprotocol.io/) server that gives agents fast, token-efficient access to Akka.NET source code directly from GitHub - no ILSpy decompilation needed.
  6. Zero config. Resolves latest Akka.NET versions automatically. Distributed as a dotnet tool.
  7. ## Quick Start
  8. ### 1. Add to your project
  9. ```bash
  10. dotnet tool install akr
  11. ```
  12. This adds akr to your `.config/dotnet-tools.json`. Run `dotnet tool restore` on any machine to install it.
  13. ### 2. Add MCP config
  14. Create `.mcp.json` in your repo root:
  15. ```json
  16. {
  17. "mcpServers": {
  18. "akr": {
  19. "command": "dotnet",
  20. "args": ["tool", "run", "akr"]
  21. }
  22. }
  23. }
  24. ```
  25. Your MCP client (Claude Code, VS Code, Cursor) discovers this automatically. Done.
  26. ### Alternative: global install
  27. ```bash
  28. dotnet tool install --global Akr
  29. ```
  30. Then configure your MCP client with `"command": "akr"` directly.
  31. ## Tools (33)
  32. | Tool | What it does |
  33. |------|-------------|
  34. | `search_source` | Regex search across all Akka.NET source |
  35. | `lookup_type` | Find a type, return its source file |
  36. | `type_members` | Compact member signatures (no bodies) |
  37. | `hosting_extensions` | List `With*`/`Add*` Akka.Hosting methods |
  38. | `config_reference` | HOCON defaults from `reference.conf` |
  39. | `stream_stages` | Catalog of Akka.Streams built-in stages |
  40. | `type_hierarchy` | Full inheritance trees (up and down) |
  41. | `find_implementations` | All implementations of an interface |
  42. | `find_messages` | Message types handled by an actor |
  43. | `message_protocol` | Request/response pairs and events |
  44. | `virtual_methods` | Overridable methods with lifecycle ordering |
  45. | `supervision_defaults` | Default supervision strategies |
  46. | `stage_detail` | Full source of a specific stream stage |
  47. | `graph_dsl_operators` | GraphDSL operators with shapes |
  48. | `stream_attributes` | Configurable stream attributes with defaults |
  49. | `journal_plugins` | Journal plugin catalog with config |
  50. | `snapshot_plugins` | Snapshot store catalog with config |
  51. | `persistence_query` | ReadJournal implementations |
  52. | `event_adapter_chain` | Event adapter configuration |
  53. | `config_tree` | Hierarchical config with Hosting/HOCON layers |
  54. | `hosting_to_hocon` | Bidirectional Hosting API to HOCON mapping |
  55. | `hosting_startup_order` | Registration ordering constraints |
  56. | `config_diff` | Config key listing per version |
  57. | `changelog` | Changelog/release notes search |
  58. | `serializer_bindings` | Serializer-to-type mapping |
  59. | `serializer_detail` | Serializer source and config |
  60. | `serialization_manifest` | Persistence event manifests |
  61. | `hosting_di_patterns` | DI integration patterns |
  62. | `hosting_testkit` | TestKit comparison (classic vs Hosting) |
  63. | `testkit_helpers` | TestKit utility catalog |
  64. | `cluster_events` | Cluster event lifecycle |
  65. | `extension_points` | Provider/plugin interfaces |
  66. | `dependency_graph` | Package dependency map |
  67. ## Usage Examples
  68. ```
  69. search_source(query: "Receive<T>")
  70. → Finds all Receive<T> calls across Akka source, 2 lines context
  71. type_members(type: "Props")
  72. → Props : IEquatable<Props>, ISurrogated
  73. Properties: Type Type { get; }
  74. Methods: static Props Create<T>(), static Props Create(Type type)
  75. Constructors: Props(Type type)
  76. hosting_extensions(filter: "Persistence")
  77. → WithSqlPersistence, WithJournalAndSnapshot, ... signatures
  78. config_reference(path: "akka.persistence")
  79. → Full HOCON config block with all defaults
  80. find_implementations(type: "IActorRef")
  81. → ActorRefBase, LocalActorRef, RemoteActorRef, ...
  82. type_hierarchy(type: "ActorBase")
  83. → UntypedActor, ReceiveActor, ActorBase → IInternalActor
  84. ```
  85. ## Covered Repositories
  86. | Repository | Packages |
  87. |------------|----------|
  88. | [akkadotnet/akka.net](https://github.com/akkadotnet/akka.net) | Akka, Remote, Cluster, Streams, Persistence, TestKit |
  89. | [akkadotnet/Akka.Hosting](https://github.com/akkadotnet/Akka.Hosting) | Hosting, Hosting.TestKit, Cluster.Hosting |
  90. | [akkadotnet/Akka.Management](https://github.com/akkadotnet/Akka.Management) | Management, Discovery.KubernetesApi |
  91. | [akkadotnet/Akka.Persistence.Sql](https://github.com/akkadotnet/Akka.Persistence.Sql) | Persistence.Sql, Persistence.Sql.Hosting |
  92. | [akkadotnet/Akka.Persistence.MongoDB](https://github.com/akkadotnet/Akka.Persistence.MongoDB) | Persistence.MongoDb, Persistence.MongoDb.Hosting |
  93. ## How It Works
  94. 1. On first tool call, akr fetches the latest release archive from each repo (~44 MB total)
  95. 2. Archives are extracted atomically to `~/.akr/sources/{repo}/{version}/`
  96. 3. All subsequent calls use the local cache - no network requests
  97. 4. Tools search cached source using regex and text parsing
  98. No GitHub token required. Archives for public repos are freely downloadable.
  99. ## Keeping akr updated
  100. akr is a local dotnet tool pinned in `.config/dotnet-tools.json`. When a new version is released:
  101. ```bash
  102. dotnet tool update akr
  103. ```
  104. If you use [Renovate](https://github.com/renovatebot/renovate), it bumps the version automatically.
  105. ## Development
  106. ```bash
  107. git clone https://github.com/st0o0/akr.git
  108. cd akr
  109. dotnet tool restore
  110. dotnet build src/akr.slnx
  111. dotnet run --project src/Akr.Tests/Akr.Tests.csproj
  112. dotnet run --project src/Akr/Akr.csproj
  113. ```
  114. ## License
  115. [MIT](LICENSE)

Ratings and comments

Sign in to rate this skill.

Sign in

Free to use. If it’s helped, pass it on.