AionMCP

io.github.kiransth77Published by GitHub account kiransth77v0.1.0Updated Oct 24, 2026

Dynamic API tool generator for OpenAPI, GraphQL, and AsyncAPI specifications

VerifiedSTDIODesktop onlyDeveloper ToolsAI & ML

Overview

AI-generated overview

A local Go MCP server that imports OpenAPI, GraphQL and AsyncAPI specifications and exposes their operations to an assistant as callable tools.

What you can do
Import OpenAPI, GraphQL and AsyncAPI specification files and turn their operations into tools the assistant can call, with hot reload so tools can change without a restart. Execute imported tools through the server's HTTP API and list what is available. Track execution statistics, learning insights and success rates, and generate self-updating documentation. Register agents and collect feedback on tool use.
When to use it
Useful when you have API specifications and want an assistant to call those APIs as tools without hand-writing an MCP wrapper for each one, especially while the specs are still changing.
Requirements
Runs as a local process built from source with Go 1.21 or higher and Git; the README also mentions a Docker image. It starts an HTTP service on localhost port 8080 and stores learning data in BoltDB. No API keys or environment variables are declared, though a log-level variable is shown for debugging.
Before you install
Imported tools execute real API operations, which may write, change or delete data depending on the specification. The server exposes an HTTP endpoint on localhost that can execute tools, so anyone who can reach that port can invoke them. It also records execution data locally for its learning features.

Installation

In SourceWeft

  1. Open AionMCP in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Desktop only via STDIO. STDIO servers start a local process, so they need the SourceWeft desktop host.

Other MCP clients

Follow the launch instructions in the repository.

README

AionMCP - Autonomous Go MCP Server

[Build Status] [Success Rate] [Avg Latency] [Go Version] [License]

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

bash
# Clone the repositorygit clone https://github.com/kiransth77/aionmcp.gitcd aionmcp
# Build the servergo 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

MetricValueStatus
Success Rate97.0%🟢 Excellent
Avg Latency250.0ms🟡 Good
Total Executions42📊 Tracking
Active Tools3🔧 Running

Statistics updated in real-time

📦 Installation

Prerequisites

  • Go 1.21 or higher
  • Git

From Source

bash
git clone https://github.com/kiransth77/aionmcp.gitcd aionmcpgo mod downloadgo 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 loggingAIONMCP_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```bashdocker 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

📄 License

📄 License

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

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

Source: README.md at commit 3ac62a0

Tools

0
SourceWeft has not started this package in its sandbox yet, so its tools are not known.

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

50% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 days25 pts

    Keep the endpoint answering the MCP handshake; SourceWeft probes it every 30 days.

  • Auth declared10 pts

    Declare the credential headers in the registry entry, or keep the endpoint answering the probe so its auth can be classified.

  • Tools listed15 pts

    Answer tools/list without a credential, or ship a package that starts in a sandbox without one.

  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts