AionMCP

AionMCP - 自主 Go MCP 服务

AionMCP 是一个基于 Go 的自主 Model Context Protocol（MCP）服务，可动态导入 OpenAPI、GraphQL 和 AsyncAPI 规范，并将其作为工具提供给 Agent。它采用整洁/六边形架构，具备自学习能力、上下文感知能力和自动文档生成功能。

🌟 主要特色

• 多协议支持：支持 OpenAPI、GraphQL 和 AsyncAPI 规范
• 自主学习：可根据执行模式持续学习并改进的系统
• 动态运行时：无需重启服务即可热重载工具
• 整洁架构：易于维护、测试和扩展的设计
• 自动文档生成：自动更新文档和洞察

📊 项目状态

当前分支：main

最新提交：f4f41db

系统健康状况：99/100（优秀）

活动工具：3

提交数（过去 7 天）：17

状态自动更新

✨ 功能

📦 包含内容

aionmcp/
├── bin/aionmcp-server              # Main executable
├── cmd/server/                     # Server entry point
├── internal/
│   ├── core/                       # HTTP/gRPC servers & tool registry
│   ├── selflearn/                  # Learning engine & BoltDB storage
│   └── autodocs/                   # Documentation generation
├── pkg/
│   ├── importer/                   # OpenAPI/GraphQL/AsyncAPI parsers
│   ├── agent/                      # Agent registration API
│   └── feedback/                   # Feedback collection
├── vscode-extension/               # VS Code extension
├── docs/                           # Comprehensive documentation
├── examples/specs/                 # Example API specifications
│   ├── petstore.yaml               # OpenAPI 3.0 example
│   ├── blog.graphql                # GraphQL example
│   └── user-events.yaml            # AsyncAPI example
└── go.mod                          # Go dependencies

🚀 快速开始

# Clone the repository
git clone https://github.com/kiransth77/aionmcp.git
cd aionmcp

# Build the server
go build -o bin/aionmcp cmd/server/main.go

# Run with default configuration
./bin/aionmcp

服务将在 http://localhost:8080 启动，并启用学习功能。

🏗️ 架构

AionMCP 遵循整洁/六边形架构原则：

┌─────────────────────────────────────────────────────────┐
│                    Adapters Layer                      │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐   │
│  │   HTTP      │  │    gRPC     │  │   Plugin    │   │
│  │  Interface  │  │  Interface  │  │  Interface  │   │
│  └─────────────┘  └─────────────┘  └─────────────┘   │
└─────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────┐
│                     Core Layer                         │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐   │
│  │    Tool     │  │  Learning   │  │    Auto     │   │
│  │  Registry   │  │   Engine    │  │    Docs     │   │
│  └─────────────┘  └─────────────┘  └─────────────┘   │
└─────────────────────────────────────────────────────────┘
┌─────────────────────────────────────────────────────────┐
│                Infrastructure Layer                    │
│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐   │
│  │   Storage   │  │   Metrics   │  │   Config    │   │
│  │  (BoltDB)   │  │(Prometheus) │  │   (Viper)   │   │
│  └─────────────┘  └─────────────┘  └─────────────┘   │
└─────────────────────────────────────────────────────────┘

📈 最近活动

最近提交

• f4f41db9 修复：清理 TOON 包的格式并移除重复的包声明 （0 小时前）
• 8b97b173 修复：更新 go-ci.yml，使用 Go 1.25 以匹配 go.mod 的要求 （0 小时前）
• ebeeee28 修复：移除 fmt.Println 中多余的换行符以通过 lint 检查 （0 小时前）
• a91eb5f4 新增：添加 TOON（面向令牌的对象表示法），用于优化大模型上下文 （0 小时前）
• bd39bb10 修复：将 Dockerfile 中的 Go 版本更新为 1.25 （0 小时前）

活动洞察

📊 洞察总数：2

活动自动更新

⚡ 性能统计

指标	数值	状态
成功率	97.0%	🟢 优秀
平均延迟	250.0ms	🟡 良好
总执行次数	42	📊 跟踪中
活动工具	3	🔧 运行中

统计数据实时更新

📦 安装

前提条件

• Go 1.21 或更高版本
• Git

从源代码安装

git clone https://github.com/kiransth77/aionmcp.git
cd aionmcp
go mod download
go build -o bin/aionmcp cmd/server/main.go

📚 使用方法

基本用法

# Start the server
./bin/aionmcp

# With custom configuration
./bin/aionmcp --config config.yaml

# Enable debug logging
AIONMCP_LOG_LEVEL=debug ./bin/aionmcp

API 端点

• GET /api/v1/tools - 列出可用工具
• POST /api/v1/tools/{tool}/execute - 执行工具
• GET /api/v1/learning/stats - 学习统计信息
• GET /api/v1/learning/insights - 系统洞察

🛠️ 开发

访问地址：http://localhost:8080

### Docker
```bash
docker run -p 8080:8080 aionmcp:latest

云端（AWS/GCP/Azure）

将二进制文件部署到云服务提供商，并通过公共 URL 访问。

嵌入式

import "github.com/aionmcp/aionmcp/internal/core"
server := core.NewServer(logger)
server.Start()

🤝 参与贡献

活动洞察

📊 洞察总数：2

活动自动更新

📄 许可证

📄 许可证

---

README 最后更新于：2025-11-27 22:47:18 AEST

此 README 会自动更新当前项目状态和指标。