MCP概念実証

このリポジトリには、 FastAPIで実装されたシンプルな Model Context Protocol (MCP) サーバーが含まれています。AWS Fargate にデプロイ可能な、検出可能でバージョン管理された API を通じて、集団データを公開することが目標です。

ローカルで実行

1. 依存関係をインストールします:

   データベースパスはDATABASE_PATH環境変数で設定できます。設定されていない場合は、デフォルトで作業ディレクトリ内のmcp.dbが使用されます。

   pip install -r requirements.txt

2. SQLite データベースをシードします。

   python -m app.seed

3. API サーバーを起動します。

   uvicorn app.main:app --reload

4. API を呼び出すときに、トークンfake-super-secret-tokenを使用して認証します。

MCP 検出ファイルはmodel_context.yamlにあります。

Related MCP server: MCP REST API Server

エージェントの使用

MCPサーバーとやり取りするためのagentパッケージが提供されています。サーバーが起動したら、以下のようにして群れのデータを一覧表示できます。

python -m agent http://localhost:8000 --token fake-super-secret-token

エージェントはmodel_context.yamlを読み取り、APIパスを検出し、サーバーからのJSONレスポンスを返します。YAMLを完全にサポートするには、オプションのPyYAML依存関係をインストールしてください。インストールしない場合は、制限付きの組み込みパーサーが使用されます。

テストの実行

pytest -q

容器

コンテナ内でサーバーを実行するためのDockerfileが提供されています。以下を使用してビルドします。

docker build -t mcp .

テラフォーム

terraformディレクトリには、コンテナをAWS（Fargateなど）にデプロイする方法を示す最小限の設定が含まれています。これにより、イメージ用のECRリポジトリが作成されます。