Aionmcp

🚀 AionMCP - Autonomous Go MCP Server

AionMCP is an autonomous Model Context Protocol (MCP) server based on Go. It can dynamically import OpenAPI, GraphQL, and AsyncAPI specifications and expose them as tools to agents. It has self - learning capabilities, context - awareness, and uses Clean/Hexagonal architecture for autonomous documentation.

🚀 Quick Start

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

✨ Features

🌟 Key Differentiators

• Multi - Protocol Support: Supports OpenAPI, GraphQL, and AsyncAPI specifications.
• Autonomous Learning: A self - improving system that learns from execution patterns.
• Dynamic Runtime: Tools can be hot - reloaded without restarting the service.
• Clean Architecture: A design that is maintainable, testable, and extensible.
• Auto - Documentation: Self - updating documentation and insights.

📦 What's Included

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

📊 Project Status

Current Branch: main

Latest Commit:

System Health: 99/100 (Excellent)

Active Tools: 3

Commits (7 days): 17

Status updated automatically

🏗️ Architecture

AionMCP follows Clean/Hexagonal Architecture principles:

┌─────────────────────────────────────────────────────────┐
│                    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

Recent Commits

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

Active Insights

📊 Total insights: 2

Activity updated automatically

⚡ Performance Statistics

Statistics updated in real - time

📦 Installation

Prerequisites

• Go 1.21 or higher
• Git

From Source

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

# 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

Docker

docker run -p 8080:8080 aionmcp:latest

Cloud (AWS/GCP/Azure)

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

Embedded

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

🤝 Contributing

Active Insights

📊 Total insights: 2

Activity updated automatically

📄 License

This project is licensed under the MIT license.

README last updated: 2025-11-27 22:47:18 AEST This README is automatically updated with current project status and metrics.