AionMCP

AionMCP - 自律型 Go MCP サーバー

AionMCP は Go ベースの自律型 Model Context Protocol（MCP）サーバーです。OpenAPI、GraphQL、AsyncAPI の仕様を動的にインポートし、エージェント向けのツールとして公開します。クリーン／ヘキサゴナルアーキテクチャを採用し、自己学習機能、コンテキスト認識、自律的なドキュメント生成を備えています。

🌟 主な差別化要素

• マルチプロトコル対応：OpenAPI、GraphQL、AsyncAPI の仕様に対応
• 自律学習：実行パターンから学習して自ら改善するシステム
• 動的ランタイム：サービスを再起動せずにツールをホットリロード
• クリーンアーキテクチャ：保守性、テスト容易性、拡張性に優れた設計
• 自動ドキュメント生成：自動更新されるドキュメントとインサイト

📊 プロジェクトの状況

現在のブランチ：main

最新のコミット：f4f41db

システムの健全性：99/100（非常に良好）

アクティブなツール：3

コミット数（過去7日間）：17

状況は自動的に更新されます

✨ 機能

📦 含まれるもの

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

🚀 クイックスタート

# 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

学習機能を有効にした状態で、サーバーが http://localhost:8080 で起動します。

🏗️ アーキテクチャ

AionMCP はクリーン／ヘキサゴナルアーキテクチャの原則に従っています。

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

📈 最近のアクティビティ

最近のコミット

• f4f41db9 修正：TOON パッケージのフォーマットを整理し、重複したパッケージ宣言を削除 (0h 前)
• 8b97b173 修正：go.mod の要件に合わせて go-ci.yml が Go 1.25 を使用するよう更新 (0h 前)
• ebeeee28 修正：リンターを通過するよう fmt.Println 内の不要な改行を削除 (0h 前)
• a91eb5f4 機能：LLM のコンテキスト最適化に TOON（Token-Oriented Object Notation）を追加 (0h 前)
• bd39bb10 修正：Dockerfile の Go バージョンを 1.25 に更新 (0h 前)

アクティブなインサイト

📊 インサイトの合計：2

アクティビティは自動的に更新されます

⚡ パフォーマンス統計

指標	値	状況
成功率	97.0%	🟢 非常に良好
平均レイテンシ	250.0ms	🟡 良好
実行総数	42	📊 記録中
アクティブなツール	3	🔧 稼働中

統計はリアルタイムで更新されます

📦 インストール

前提条件

• Go 1.21 以降
• Git

ソースからインストール

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

📚 使用方法

基本的な使用方法

# Start the server
./bin/aionmcp

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

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

API エンドポイント

• GET /api/v1/tools - 利用可能なツールの一覧を取得
• POST /api/v1/tools/{tool}/execute - ツールを実行
• GET /api/v1/learning/stats - 学習統計を取得
• GET /api/v1/learning/insights - システムのインサイトを取得

🛠️ 開発

アクセス先：http://localhost:8080

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

クラウド（AWS/GCP/Azure）

バイナリをクラウドプロバイダーにデプロイし、パブリック URL からアクセスします。

組み込み

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

🤝 コントリビューション

アクティブなインサイト

📊 インサイトの合計：2

アクティビティは自動的に更新されます

📄 ライセンス

📄 ライセンス

---

README の最終更新：2025-11-27 22:47:18 AEST

この README は、現在のプロジェクト状況とメトリクスに合わせて自動的に更新されます。