AionMCP

平台与服务

by kiransth77

可根据 OpenAPI、GraphQL 与 AsyncAPI 规范动态生成 API 工具的生成器。

什么是 AionMCP

可根据 OpenAPI、GraphQL 与 AsyncAPI 规范动态生成 API 工具的生成器。

README

AionMCP - Autonomous Go MCP Server

<!-- AUTO-GENERATED BADGES -->

Build Status Success Rate Avg Latency Go Version License

<!-- END AUTO-GENERATED BADGES -->

AionMCP is an autonomous Go-based Model Context Protocol (MCP) server that dynamically imports OpenAPI, GraphQL, and AsyncAPI specifications and exposes them as tools to agents. It features self-learning capabilities, context-awareness, and autonomous documentation using Clean/Hexagonal architecture.

🌟 Key Differentiators

  • Multi-Protocol Support: OpenAPI, GraphQL, and AsyncAPI specifications
  • Autonomous Learning: Self-improving system that learns from execution patterns
  • Dynamic Runtime: Hot-reloadable tools without service restart
  • Clean Architecture: Maintainable, testable, and extensible design
  • Auto-Documentation: Self-updating documentation and insights

📊 Project Status

<!-- AUTO-GENERATED STATUS -->

Current Branch: main

Latest Commit: f4f41db

System Health: 99/100 (Excellent)

Active Tools: 3

Commits (7 days): 17

Status updated automatically

<!-- END AUTO-GENERATED STATUS -->

✨ Features

📦 What's Included

code
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

🚀 Quick Start

bash
# 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

The server will start on http://localhost:8080 with learning enabled.

🏗️ Architecture

AionMCP follows Clean/Hexagonal Architecture principles:

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

📈 Recent Activity

<!-- AUTO-GENERATED ACTIVITY -->

Recent Commits

  • f4f41db9 fix: clean up TOON package formatting and remove duplicate package declaration (0h ago)
  • 8b97b173 fix: update go-ci.yml to use Go 1.25 to match go.mod requirement (0h ago)
  • ebeeee28 fix: remove redundant newline in fmt.Println to pass linting (0h ago)
  • a91eb5f4 feat: add TOON (Token-Oriented Object Notation) for LLM context optimization (0h ago)
  • bd39bb10 fix: update Dockerfile Go version to 1.25 (0h ago)

Active Insights

📊 Total insights: 2

Activity updated automatically

<!-- END AUTO-GENERATED ACTIVITY -->

⚡ Performance Statistics

<!-- AUTO-GENERATED PERFORMANCE -->
MetricValueStatus
Success Rate97.0%🟢 Excellent
Avg Latency250.0ms🟡 Good
Total Executions42📊 Tracking
Active Tools3🔧 Running

Statistics updated in real-time

<!-- END AUTO-GENERATED PERFORMANCE -->

📦 Installation

Prerequisites

  • Go 1.21 or higher
  • Git

From Source

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

📚 Usage

Basic Usage

bash
# Start the server
./bin/aionmcp

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

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

API Endpoints

  • GET /api/v1/tools - List available tools
  • POST /api/v1/tools/{tool}/execute - Execute a tool
  • GET /api/v1/learning/stats - Learning statistics
  • GET /api/v1/learning/insights - System insights

🛠️ Development

Access: http://localhost:8080

code

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

Cloud (AWS/GCP/Azure)

Deploy the binary to your cloud provider, access via public URL.

Embedded

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

🤝 Contributing

Active Insights

📊 Total insights: 2

Activity updated automatically

<!-- END AUTO-GENERATED ACTIVITY -->

📄 License

📄 License


README last updated: 2025-11-27 22:47:18 AEST

This README is automatically updated with current project status and metrics.

常见问题

AionMCP 是什么?

可根据 OpenAPI、GraphQL 与 AsyncAPI 规范动态生成 API 工具的生成器。

相关 Skills

Slack动图

by anthropics

Universal
热门

面向Slack的动图制作Skill,内置emoji/消息GIF的尺寸、帧率和色彩约束、校验与优化流程,适合把创意或上传图片快速做成可直接发送的Slack动画。

帮你快速做出适配 Slack 的动图,内置约束规则和校验工具,少踩上传与播放坑,做表情包和演示都更省心。

平台与服务
未扫描165.3k

MCP构建

by anthropics

Universal
热门

聚焦高质量 MCP Server 开发,覆盖协议研究、工具设计、错误处理与传输选型,适合用 FastMCP 或 MCP SDK 对接外部 API、封装服务能力。

想让 LLM 稳定调用外部 API,就用 MCP构建:从 Python 到 Node 都有成熟指引,帮你更快做出高质量 MCP 服务器。

平台与服务
未扫描165.3k

接口测试套件

by alirezarezvani

Universal
热门

扫描 Next.js、Express、FastAPI、Django REST 的 API 路由,自动生成覆盖鉴权、参数校验、错误码、分页、上传与限流场景的 Vitest 或 Pytest 测试套件。

帮你把API与集成测试自动化跑顺,减少回归漏测;能力全面,尤其适合复杂接口场景的QA团队。

平台与服务
未扫描23.5k

相关 MCP Server

Slack 消息

编辑精选

by Anthropic

热门

Slack 是让 AI 助手直接读写你的 Slack 频道和消息的 MCP 服务器。

这个服务器解决了团队协作中需要 AI 实时获取 Slack 信息的痛点,特别适合开发团队让 Claude 帮忙汇总频道讨论或发送通知。不过,它目前只是参考实现,文档有限,不建议在生产环境直接使用——更适合开发者学习 MCP 如何集成第三方服务。

平台与服务
89.1k

by netdata

热门

io.github.netdata/mcp-server 是让 AI 助手实时监控服务器指标和日志的 MCP 服务器。

这个工具解决了运维人员需要手动检查系统状态的痛点,最适合 DevOps 团队让 Claude 自动分析性能数据。不过,它依赖 NetData 的现有部署,如果你没用过这个监控平台,得先花时间配置。

平台与服务
79.9k

by d4vinci

热门

Scrapling MCP Server 是专为现代网页设计的智能爬虫工具,支持绕过 Cloudflare 等反爬机制。

这个工具解决了爬取动态网页和反爬网站时的头疼问题,特别适合需要批量采集电商价格或新闻数据的开发者。不过,它依赖外部浏览器引擎,资源消耗较大,不适合轻量级任务。

平台与服务
71.9k

评论