MCP(Model Context Protocol) 서버는 Minds를 위해 LLM을 사용하여 표준 인터페이스를 통해 Minds SDK와 상호 작용할 수 있습니다.

설치

필요한 의존성 설치 (실행 환경 권장)

구성

서버는 환경 변수를 사용하여 구성될 수 있습니다:

FastMCP 설정

• FASTMCP_DEBUG: 디버그 모드(기본값: false)
• FASTMCP_LOG_LEVEL: 로그 레벨 설정 (기본값: INFO)
• FASTMCP_HOST: (기본값: 0.0.0.0)
• FASTMCP_PORT: 포트 (기본값: 8000)
• FASTMCP_SSE_PATH: SSE 이벤트 경로 (과태: /sse)
• FASTMCP_MESSAGE_PATH: 메시지 경로 (과태: /messages/)

마음 설정

• 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