Axon。MCP。服务器
AI IDE的模型上下文协议(MCP)服务器——光标、反重力和克劳德
*使用Cursor IDE、Google AntiGravity和启用MCP的助手将您的代码库转换为人工智能驱动开发的智能知识库*
______________________________________________________________________
](https://www.python.org/downloads/)    ](https://github.com/ali-kamali/Axon.MCP.Server/pkgs/container/axon-mcp-server)    
______________________________________________________________________
📋 目录
______________________________________________________________________
🎯 问题
现代代码库是复杂的迷宫——数千个文件、复杂的依赖关系和不断发展的架构。 像ChatGPT和Claude这样的人工智能助手非常出色。..但他们正在盲目飞行。 如果不深入了解代码库的结构、关系和模式,他们只能看到树,而不能看到森林。
💡 解决方案
Axon。MCP。服务器 使用 模型上下文协议(MCP)。可以把它看作是让你的人工智能助手对你的代码进行X射线视觉——不仅理解语法,还理解语义、架构和关系。
Axon为何脱颖而出
- 🧠 语义理解:超越grep理解什么代码 *手段*,而不仅仅是它所说的
- 🔗 关系映射:自动构建调用图、继承树和依赖关系网络
- 🤖 AI原生集成:专为ChatGPT、Claude、Cursor IDE和其他启用MCP的工具构建
- 📊 多语言掌握:C#(Roslyn)、Python、JavaScript、TypeScript的深度分析
- 🔍 矢量搜索:使用语义嵌入按含义查找代码
- 🏗️ 建筑智能:自动检测服务、API、实体框架映射、设计模式
- ⚡ 生产就绪性能:\ 💡 专业提示: 看看 开发指南 用于本地开发设置和测试。
______________________________________________________________________
🎯 用例
🚀 主要:AI IDE集成(光标、反重力、VS代码)
Axon MCP Server的主要目的是为AI驱动的IDE提供深度代码智能:
光标IDE
- 上下文代码完成:AI理解你的整个代码库结构
- 智能聊天:询问有关架构、依赖关系和实现细节的问题
- 语义代码搜索:根据代码的功能查找代码,而不仅仅是它的名称
- 重构协助:AI知道整个代码库中的所有用法
谷歌反重力
- Vibe编码智能对代码模式和架构有深入的理解
- 跨存储库上下文:无缝地处理多个项目
- 智能代码生成:基于您实际代码库模式的AI建议
- 实时文档:复杂代码段的即时解释
其他启用MCP的工具
- 克劳德桌面版:询问有关代码库的自然语言问题
- 带MCP的ChatGPT:深度代码分析和架构见解
- 自定义MCP客户端:构建自己的AI驱动开发工具
📊 对于开发团队
- 入职:新开发人员可以问“身份验证是如何工作的?”并得到全面的答案
- 代码审查:人工智能辅助审查,充分考虑依赖关系和影响
- 文档:自动生成复杂模块的解释
- 影响分析:“如果我更改此API会中断什么?”带有完整的依赖关系跟踪
🔍 面向软件架构师
- 架构可视化:自动生成的服务依赖关系图
- 设计模式检测:识别代码库中的模式和反模式
- 技术债务分析:查找复杂、紧密耦合的代码段
- 迁移规划:在主要重构之前了解所有依赖关系
______________________________________________________________________
📚 文档
🏗 建筑
📖 指南
🔌 API和工具
- REST API参考 -API端点和使用
- MCP工具参考 -用于AI助手的MCP工具
⚙️ 参考
______________________________________________________________________
🔧 发展
# Install dependencies
make dev-install
# Run tests
make test
# Start API (dev mode with hot reload)
make api-dev
# Start MCP server
make mcp-dev
# Start UI
make ui-dev
# Lint and format
make lint
make format______________________________________________________________________
🌟 是什么让这个特别?
- 混合智能:句法(树型)+语义(Roslyn)分析
- AI优先设计:专门为AI助手提供代码上下文而构建
- 生产级:真实身份验证、监控、分布式处理、缓存
- 多源:支持GitLab和Azure DevOps
- 深度C#支持:通过Roslyn进行编译器等级分析
- 语义搜索:矢量嵌入支持“查找相似代码”查询
- 建筑意识:检测服务、API、实体,而不仅仅是函数
______________________________________________________________________
🗺️ 路线图
这个项目是 积极维护 并不断发展。以下是我们即将看到的:
✅ 已完成(v3.2-当前)
- \[x\] API身份验证:用于混合身份验证方案的JWT令牌+API密钥
- \[x\] 混合验证:使用cookie的UI登录+编程API密钥访问
- \[x\] 内存优化:用于高效处理大型数据集的键集分页
- \[x\] 向量搜索:基于pgvector嵌入的语义代码搜索
- \[x\] 多语言支持:Python、JavaScript、TypeScript、C#(通过Roslyn)
🚧 正在进行中(v3.2→ v3.3)
- \[ \] Roslyn流程经理重构:改善稳定性和资源管理
- \[ \] 管道模式重构器:更模块化和可测试的处理架构
🎯 下一版本(v3.3-2026年第一季度)
- \[ \] RAG管道:询问有关代码库的自然语言问题(“身份验证是如何工作的?”)
- \[ \] 架构可视化:从代码结构自动生成Mermaid/PlantUML图
- \[ \] 影响分析工具:在更改之前,先看看会发生什么(“什么取决于UserService?”)
- \[ \] 对话记忆:具有上下文保留功能的多回合人工智能对话
🚀 未来增强功能(v4.0+)
- \[ \] AI测试生成:自动为代码生成单元测试
- \[ \] 代码审查助理:人工智能支持的公关审查,包括安全和质量检查
- \[ \] 复杂性热图:视觉复杂性分析,以确定重构候选者
- \[ \] 依赖性审计:跟踪和可视化包依赖关系和漏洞
- \[ \] 语言扩展:Java、Go、Rust、Ruby、PHP支持
- \[ \] IDE插件:VS代码、JetBrains IDE的原生插件
- \[ \] 协作功能:团队注释、共享搜索、代码库书签
💡 有一个功能想法吗? 在我们的GitLab仓库上打开一个问题!
______________________________________________________________________
📄 许可证和商业使用
Axon。MCP。服务器 获得双重许可,以确保可持续性和快速发展。
1.开源(AGPLv3)
该项目是自由软件 GNU Affero通用公共许可证v3.0(AGPLv3).
- 最适合: 开源项目、业余爱好者、研究人员和教育用途。
- 规则: 如果修改此代码或在可通过网络访问的服务中使用它,则 必须 在相同的AGPLv3许可证下开源您自己的项目。
- 细节: 请参阅 许可证 文件以获取完整条款。
2.商业许可证(企业)
想要将Axon集成到专有/闭源产品中吗?
- 最适合: 无法开源代码的初创公司、企业和SaaS产品。
- 优点:
- 根据您自己的专有许可发布您的产品 - 无需共享源代码 - 优先支持和直接联系维护人员 - 法律赔偿选项 - 自定义功能和集成
📩 联系我们 获得商业许可证。
______________________________________________________________________
为什么双重许可?
我们相信开源 和 持续性。AGPLv3确保社区从改进中受益,而商业许可证则为持续开发、全面测试和企业功能提供资金,使每个人都受益。
______________________________________________________________________
🤝 贡献
我们欢迎社区的贡献!无论是bug修复、新功能还是文档改进,您的帮助都会使这个项目变得更好。
1.“现实”检验:CLA
由于这个项目是双重许可的,我们必须确保我们有分配捐款的合法权利。
在合并任何PR之前,我们要求贡献者回复一条评论:
*“我特此将此贡献的版权转让给项目维护者,并同意《贡献者许可协议》的条款。”*
2.入门
- 分叉存储库
- 创建要素分支(
git checkout -b feature/amazing-feature) - 提交您的更改(
git commit -m 'Add amazing feature') - 推到分支(
git push origin feature/amazing-feature) - 打开拉取请求
3.准则
- 📘 开发指南 -设置、编码标准和最佳实践
- ✅ 代码质量:我们使用Black、mypy和pylint来保证代码质量
- 🧪 测试:对所有新代码保持>80%的测试覆盖率
- 🔄 拉取请求:遵循我们的公关模板,确保CI通过
______________________________________________________________________
📞 支持与社区
需要帮助或想讨论功能?
- 🐛 错误报告:
- 📖 文档:浏览
docs/目录 - 💬 社区:加入我们
#axon-mcp-server(内部Slack) - ❓ 问题:在GitHub上打开讨论或问题
______________________________________________________________________
建于❤️ Axon DevOps团队
*赋予开发人员AI驱动的代码智能*
](https://github.com/ali-kamali/Axon.MCP.Server)
