AionMCP

AionMCP - Autonomous Go MCP Server

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

Current Branch: main

Latest Commit: f4f41db

System Health: 99/100 (Excellent)

Active Tools: 3

Commits (7 days): 17

*Status updated automatically*

✨ Features

📦 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

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

🏗️ 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

• 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*

⚡ 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

Access: http://localhost:8080

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

📄 License

---

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

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