{
  "markdown": "# AionMCP - Autonomous Go MCP Server\n\n<!-- AUTO-GENERATED BADGES -->\n![Build Status](https://img.shields.io/badge/build-passing-brightgreen)\n![Success Rate](https://img.shields.io/badge/success_rate-97%25-brightgreen)\n![Avg Latency](https://img.shields.io/badge/avg_latency-250ms-green)\n![Go Version](https://img.shields.io/badge/go-1.21+-blue)\n![License](https://img.shields.io/badge/license-MIT-blue)\n<!-- END AUTO-GENERATED BADGES -->\n\nAionMCP 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.\n\n## 🌟 Key Differentiators\n\n- **Multi-Protocol Support**: OpenAPI, GraphQL, and AsyncAPI specifications\n- **Autonomous Learning**: Self-improving system that learns from execution patterns\n- **Dynamic Runtime**: Hot-reloadable tools without service restart\n- **Clean Architecture**: Maintainable, testable, and extensible design\n- **Auto-Documentation**: Self-updating documentation and insights\n\n## 📊 Project Status\n\n<!-- AUTO-GENERATED STATUS -->\n**Current Branch**: `main`\n\n**Latest Commit**: [`f4f41db`](../../commit/f4f41db9fffc0d43c67153b80d68480905f7c3d3)\n\n**System Health**: 99/100 (Excellent)\n\n**Active Tools**: 3\n\n**Commits (7 days)**: 17\n\n*Status updated automatically*\n<!-- END AUTO-GENERATED STATUS -->\n\n## ✨ Features\n\n## 📦 What's Included\n\n```\naionmcp/\n├── bin/aionmcp-server              # Main executable\n├── cmd/server/                     # Server entry point\n├── internal/\n│   ├── core/                       # HTTP/gRPC servers & tool registry\n│   ├── selflearn/                  # Learning engine & BoltDB storage\n│   └── autodocs/                   # Documentation generation\n├── pkg/\n│   ├── importer/                   # OpenAPI/GraphQL/AsyncAPI parsers\n│   ├── agent/                      # Agent registration API\n│   └── feedback/                   # Feedback collection\n├── vscode-extension/               # VS Code extension\n├── docs/                           # Comprehensive documentation\n├── examples/specs/                 # Example API specifications\n│   ├── petstore.yaml               # OpenAPI 3.0 example\n│   ├── blog.graphql                # GraphQL example\n│   └── user-events.yaml            # AsyncAPI example\n└── go.mod                          # Go dependencies\n```\n## 🚀 Quick Start\n\n```bash\n# Clone the repository\ngit clone https://github.com/kiransth77/aionmcp.git\ncd aionmcp\n\n# Build the server\ngo build -o bin/aionmcp cmd/server/main.go\n\n# Run with default configuration\n./bin/aionmcp\n```\n\nThe server will start on `http://localhost:8080` with learning enabled.\n\n## 🏗️ Architecture\n\nAionMCP follows Clean/Hexagonal Architecture principles:\n\n```\n┌─────────────────────────────────────────────────────────┐\n│                    Adapters Layer                      │\n│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐   │\n│  │   HTTP      │  │    gRPC     │  │   Plugin    │   │\n│  │  Interface  │  │  Interface  │  │  Interface  │   │\n│  └─────────────┘  └─────────────┘  └─────────────┘   │\n└─────────────────────────────────────────────────────────┘\n┌─────────────────────────────────────────────────────────┐\n│                     Core Layer                         │\n│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐   │\n│  │    Tool     │  │  Learning   │  │    Auto     │   │\n│  │  Registry   │  │   Engine    │  │    Docs     │   │\n│  └─────────────┘  └─────────────┘  └─────────────┘   │\n└─────────────────────────────────────────────────────────┘\n┌─────────────────────────────────────────────────────────┐\n│                Infrastructure Layer                    │\n│  ┌─────────────┐  ┌─────────────┐  ┌─────────────┐   │\n│  │   Storage   │  │   Metrics   │  │   Config    │   │\n│  │  (BoltDB)   │  │(Prometheus) │  │   (Viper)   │   │\n│  └─────────────┘  └─────────────┘  └─────────────┘   │\n└─────────────────────────────────────────────────────────┘\n```\n\n## 📈 Recent Activity\n\n<!-- AUTO-GENERATED ACTIVITY -->\n### Recent Commits\n\n- [`f4f41db9`](../../commit/f4f41db9fffc0d43c67153b80d68480905f7c3d3) fix: clean up TOON package formatting and remove duplicate package declaration *(0h ago)*\n- [`8b97b173`](../../commit/8b97b173d7a8b7b5521f03e6ef9f901b28603541) fix: update go-ci.yml to use Go 1.25 to match go.mod requirement *(0h ago)*\n- [`ebeeee28`](../../commit/ebeeee2896733d1c8ff3da684e052b451f195bab) fix: remove redundant newline in fmt.Println to pass linting *(0h ago)*\n- [`a91eb5f4`](../../commit/a91eb5f414c56f9e0d5b92a5f189f94e374bc452) feat: add TOON (Token-Oriented Object Notation) for LLM context optimization *(0h ago)*\n- [`bd39bb10`](../../commit/bd39bb1023fe6886d712a6b2900b5537f108940a) fix: update Dockerfile Go version to 1.25 *(0h ago)*\n\n### Active Insights\n\n📊 Total insights: 2\n\n*Activity updated automatically*\n<!-- END AUTO-GENERATED ACTIVITY -->\n\n## ⚡ Performance Statistics\n\n<!-- AUTO-GENERATED PERFORMANCE -->\n| Metric | Value | Status |\n|--------|-------|--------|\n| Success Rate | 97.0% | 🟢 Excellent |\n| Avg Latency | 250.0ms | 🟡 Good |\n| Total Executions | 42 | 📊 Tracking |\n| Active Tools | 3 | 🔧 Running |\n\n*Statistics updated in real-time*\n<!-- END AUTO-GENERATED PERFORMANCE -->\n\n## 📦 Installation\n\n### Prerequisites\n\n- Go 1.21 or higher\n- Git\n\n### From Source\n\n```bash\ngit clone https://github.com/kiransth77/aionmcp.git\ncd aionmcp\ngo mod download\ngo build -o bin/aionmcp cmd/server/main.go\n```\n## 📚 Usage\n\n### Basic Usage\n\n```bash\n# Start the server\n./bin/aionmcp\n\n# With custom configuration\n./bin/aionmcp --config config.yaml\n\n# Enable debug logging\nAIONMCP_LOG_LEVEL=debug ./bin/aionmcp\n```\n\n### API Endpoints\n\n- `GET /api/v1/tools` - List available tools\n- `POST /api/v1/tools/{tool}/execute` - Execute a tool\n- `GET /api/v1/learning/stats` - Learning statistics\n- `GET /api/v1/learning/insights` - System insights\n## 🛠️ Development\n\n# Access: http://localhost:8080\n```\n\n### Docker\n```bash\ndocker run -p 8080:8080 aionmcp:latest\n```\n\n### Cloud (AWS/GCP/Azure)\nDeploy the binary to your cloud provider, access via public URL.\n\n### Embedded\n```go\nimport \"github.com/aionmcp/aionmcp/internal/core\"\nserver := core.NewServer(logger)\nserver.Start()\n```\n## 🤝 Contributing\n\n### Active Insights\n\n📊 Total insights: 2\n\n*Activity updated automatically*\n<!-- END AUTO-GENERATED ACTIVITY -->\n## 📄 License\n\n## 📄 License\n---\n\n*README last updated: 2025-11-27 22:47:18 AEST*\n\n*This README is automatically updated with current project status and metrics.*\n",
  "bytes": 6602,
  "sha": "4b6dfebf8ad8f6b57aea9d034bed7780b311d514bdc367834e79c4c95eeb1d14",
  "repo_slug": "kiransth77/aionmcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_kiransth77_aionmcp_ff989fbc/readme"
}