mcp-server
Health Warn
- License — License: MIT
- Description — Repository has a description
- Active repo — Last push 0 days ago
- Low visibility — Only 7 GitHub stars
Code Pass
- Code scan — Scanned 6 files during light audit, no dangerous patterns found
Permissions Pass
- Permissions — No dangerous permissions requested
No AI report is available for this listing yet.
MCP server that brings ALCops AL code analyzers to AI assistants like Claude and Cursor
ALCops MCP Server
An MCP server that brings ALCops AL code analysis to AI assistants. Lets Claude, Cursor, and other MCP clients analyze Business Central AL projects, browse rules, and apply code fixes — all without leaving the conversation.
Quick Start
Install as a .NET global tool:
dotnet tool install -g ALCops.Mcp
Add to your .mcp.json (Claude Code) or claude_desktop_config.json (Claude Desktop):
{
"mcpServers": {
"alcops": {
"command": "alcops-mcp"
}
}
}
That's it. If you have the AL Language VS Code extension installed, the server picks up the BC Development Tools automatically.
Requirements
- .NET 10.0 SDK or Runtime
- AL Language VS Code extension v17.0 or higher
Note: AL Language v16 and earlier are not supported. The BC Development Tools DLLs introduced breaking API changes in v17 that are not backwards compatible. AL Language v18+ requires .NET 10.
Tools
4 tools, ~1,020 tokens of schema overhead.
| Tool | Description |
|---|---|
analyze |
Run analyzers on an AL project or file. Returns diagnostics with severity, location, and code fix availability. |
list_rules |
List all available analyzer rules with metadata (ID, title, severity, category, cop). |
get_fixes |
Get available code fixes for a specific diagnostic at a location. |
apply_fix |
Apply a code fix and return the modified source — does not write to disk. |
Analyzers
The server always includes ALCops' 6 built-in cops:
| Cop | Prefix | Description |
|---|---|---|
| ApplicationCop | AC | Correct modeling and behavior of BC objects |
| DocumentationCop | DC | Documentation quality and completeness |
| FormattingCop | FC | Stylistic and syntactic consistency |
| LinterCop | LC | Code smells, maintainability, best practices |
| PlatformCop | PC | AL language and runtime semantic correctness |
| TestCop | TC | Test codeunit structure and correctness |
Additionally, the server can load BC standard analyzers (${CodeCop}, ${UICop}, ${PerTenantExtensionCop}, ${AppSourceCop}) and third-party analyzers — auto-discovered from al.codeAnalyzers in .vscode/settings.json, or passed explicitly via the analyzers tool parameter.
Browse the complete rules reference at alcops.dev/docs/analyzers.
BC DevTools Resolution
The server needs Microsoft BC Development Tools at runtime (not bundled due to licensing). On startup it searches, in order:
BCDEVELOPMENTTOOLSPATHenvironment variable- AL Language VS Code extension
- Local cache (
~/.alcops/cache/devtools/) - .NET global tools cache
- Auto-download from NuGet (first run only)
Most users have the AL extension installed, so no extra setup is needed.
Contributing
Contributions are welcome! Whether it's a new tool, a bug report, or a pull request — all input helps.
- 🐛 Report a bug — File an Issue
- 🔧 Submit a PR — Fork the repo, create a branch, and open a pull request
License
This project is licensed under the MIT License.
Reviews (0)
Sign in to leave a review.
Leave a reviewNo results found