Optimized Memory MCP Server v2

最適化メモリ MCP サーバー v2

Claude Desktop との連携に最適化された、高性能な Python ベースの Model Context Protocol（MCP）サーバー実装です。このサーバーは、効率的なメモリ管理と堅牢なインフラストラクチャコンポーネントの追跡機能を提供します。

注意

プロジェクトの仕様に問題があり、AI の指示によって無限ループが発生したため、このプロジェクトはアーカイブされました。

概要

この MCP サーバー実装は、以下に重点を置いています。

• 大規模なインフラストラクチャ追跡のための効率的なメモリ管理
• MCP のパターンに沿った包括的なリソースとツールの実装
• Claude Desktop との完全な互換性
• コネクションプーリングを備えた SQLite ベースの永続ストレージ
• 堅牢なエラー処理とリソースのクリーンアップ

機能

• MCP リソース

  • エンティティ管理（一覧表示、取得、関係性）
  • プロバイダーリソースの追跡
  • Ansible コレクション管理
  • バージョン追跡
  • 全文検索機能

• MCP ツール

  • エンティティの作成と管理
  • オブザベーションの追跡
  • プロバイダーの登録
  • Ansible モジュールの統合
  • インフラストラクチャ分析ツール

• コアコンポーネント

  • FastMCP サーバーの実装
  • コネクションプーリングを備えた SQLite データベース
  • 包括的なエラー処理
  • リソースの自動クリーンアップ
  • 詳細なログ記録

プロジェクト構成

.
├── src/
│   ├── resources/          # MCP resource implementations
│   ├── tools/             # MCP tool implementations
│   ├── db/                # Database management
│   ├── utils/             # Utility functions
│   └── server.py          # Main server implementation
├── tests/
│   ├── resources/         # Resource tests
│   ├── tools/             # Tool tests
│   └── integration/       # Integration tests
├── docs/                  # Documentation
├── migrations/            # Database migrations
└── requirements/          # Project dependencies

要件

• Python 3.13.1 以降
• SQLite 3.x
• uvx サーバー

クイックスタート

詳しいインストール手順については、環境セットアップガイドを参照してください。

主な手順：

1. リポジトリをクローンし、Python 環境をセットアップする
2. 依存関係をインストールする：pip install -r requirements.txt
3. データベースを設定する：export DATABASE_URL=sqlite:///path/to/db.db
4. データベースを初期化する：alembic upgrade head
5. サーバーを起動する：uvx run python -m src.main

使用方法

1. サーバーを起動します：

   uvx run python -m src.main
   

2. Claude Desktop を設定します：

   • MCP サーバーの URL を http://localhost:8000 に設定します
   • Claude の設定で MCP プロトコルを有効にします

3. 接続を確認します：

   curl http://localhost:8000/health
   

開発環境のセットアップ

1. 開発用の依存関係をインストールします：

   pip install -r requirements-dev.txt
   

2. pre-commit フックをセットアップします：

   pre-commit install
   

3. テストを実行します：

   pytest
   

4. コード品質をチェックします：

   flake8
   mypy .
   

貢献

1. リポジトリをフォークします
2. 機能ブランチを作成します
3. プロジェクトの規約に従って変更を加えます
4. テストとリンティングを実行します
5. プルリクエストを送信します

ドキュメント

• 環境セットアップガイド - インストールと設定
• MCP 使用ガイド - MCP リソースとツールの使用方法
• API ドキュメント - API リファレンス
• 設定ガイド - サーバーの設定
• 開発ガイド - 貢献ガイドライン
• データベーススキーマ - データモデルのリファレンス
• トラブルシューティングガイド - よくある問題と解決策

ライセンス

このプロジェクトは MIT ライセンスの下でライセンスされています。詳細については、LICENSEファイルを参照してください。

謝辞

• MCP プロトコル仕様を提供してくださった Claude Desktop チーム
• FastMCP ライブラリへの貢献者の皆さま
• データベースツールを提供してくださった SQLAlchemy チーム