MCP (Model Context Protocol) サーバは、LLM が標準インターフェイスで Minds SDK と連携できるようにします。

インストール

必要な依存関係をインストール(仮想環境推奨)

設定

環境変数を使用してサーバーを構成できます。

FastMCP 設定

• [FASTMCP_HOST: 結合するホスト (デフォルト: 0.0.0.0)
• [FASTMCP_PORT: ポートをバインド (デフォルト: 8000)
• [FASTMCP_SSE_PATH]: SSE イベントのパス (デフォルト: /sse)

マインド設定

• [MINDS_BASE_URL: Minds API のベース URL (デフォルト: https://mdb.ai))

使用法

サーバーの起動

###リソーステンプレート

サーバは、MCP 仕様に従って、次のリソーステンプレートを公開します。

• [minds://{api_key} - 利用可能なすべてのマインドを一覧表示
• [minds://{mind_name}/{api_key} - 名前で特定のマインドを取得する

ツールテンプレート

サーバは、次のツールテンプレートを提供します。

• [completion - 指定されたマインドを使用して完了を生成します
• 変数:
• [mind_name: 利用するマインドのID

Minds MCP Server

An MCP (Model Context Protocol) server for Minds, allowing LLMs to interact with the Minds SDK through a standardized interface.

Installation

Install the required dependencies (virtual environment recommended)

python -m venv env
source env/bin/activate

pip install -r requirements.txt
pip install -r requirements-dev.txt

Configuration

The server can be configured using environment variables:

FastMCP Settings

• FASTMCP_DEBUG: Enable debug mode (default: false)
• FASTMCP_LOG_LEVEL: Set log level (default: INFO)
• FASTMCP_HOST: Host to bind to (default: 0.0.0.0)
• FASTMCP_PORT: Port to bind to (default: 8000)
• FASTMCP_SSE_PATH: Path for SSE events (default: /sse)
• FASTMCP_MESSAGE_PATH: Path for messages (default: /messages/)

Minds Settings

• MINDS_BASE_URL: Base URL for the Minds API (default: https://mdb.ai)

Usage

Starting the Server

python -m server

Resource Templates

The server exposes the following resource templates according to the MCP specification:

• minds://{api_key} - List all available Minds
• minds://{mind_name}/{api_key} - Get a specific Mind by name

Tool Templates

The server provides the following tool templates:

• completion - Generate a completion using a specified Mind
  • Parameters:
    • mind_name: The ID of the Mind to use
    • message: The message to complete
    • api_key: The Minds API key

Development

Running Tests

# Run all tests
python -m pytest

# Run only unit tests
python -m pytest tests/unit

Development Mode

For easier development, you can use the MCP development server:

mcp dev server.py

This will start the server and open the MCP Inspector in your browser for testing.

MCP Protocol

This server implements the Model Context Protocol (MCP), which provides:

• Resource Templates: Parameterized URL patterns for retrieving data
• Tool Templates: Function signatures for executing actions
• Prompt Templates: Reusable interaction templates (not used in this server)

MCP clients can:

1. Discover available resource and tool templates
2. Instantiate templates with parameters
3. Access resources and call tools in a standardized way