feat: add Model Context Protocol (MCP) support

[ErikBjare]

Implements MCP server functionality allowing gptme to be used through the Model Context Protocol.

• Add core MCP types and transport layer
• Implement MCP server with tool/resource support
• Add CLI entry point (gptme-mcp-server)
• Add documentation and examples
• Add tests for MCP implementation

Part of #286

@TimeToBuildBob wrote this.

---

Important

Adds Model Context Protocol (MCP) server support to gptme, including core types, transport, server implementation, CLI entry point, documentation, and tests.

• Behavior:
  • Implements MCP server functionality in gptme/mcp/__init__.py, allowing gptme to be used through the Model Context Protocol.
  • Adds CLI entry point gptme-mcp-server in gptme/mcp/cli_server.py.
• Core Components:
  • Defines core MCP types in gptme/mcp/types.py.
  • Implements transport layer in gptme/mcp/transport.py.
  • Implements server functionality in gptme/mcp/server.py.
• Documentation:
  • Updates README.md to include MCP support.
  • Adds docs/mcp.rst and docs/examples/mcp.rst for detailed MCP documentation and examples.
• Testing:
  • Adds tests for MCP implementation in tests/test_mcp.py.
• Misc:
  • Updates pyproject.toml to include new CLI entry point and test dependencies.

^{This description was created by for 51f2b7c. It will automatically update as commits are pushed.}

[ellipsis-dev]

👍 Looks good to me! Reviewed everything up to 51f2b7c in 1 minute and 2 seconds

More details

• Looked at 1092 lines of code in 12 files
• Skipped 2 files when reviewing.
• Skipped posting 4 drafted comments based on config settings.

1. gptme/mcp/__init__.py:43

• Draft comment:
  Consider retrieving the version dynamically from the package metadata to avoid hardcoding it here.
• Reason this comment was not posted:
  Confidence changes required: 50%
  The version number is hardcoded, which can lead to inconsistencies if the package version changes.

2. gptme/mcp/server.py:92

• Draft comment:
  Consider providing a more descriptive error message here to aid in debugging.
• Reason this comment was not posted:
  Confidence changes required: 50%
  The error message should be more descriptive to help with debugging.

3. gptme/mcp/transport.py:119

• Draft comment:
  Consider providing a more descriptive error message here to aid in debugging.
• Reason this comment was not posted:
  Confidence changes required: 50%
  The error message should be more descriptive to help with debugging.

4. gptme/mcp/transport.py:128

• Draft comment:
  Consider providing a more descriptive error message here to aid in debugging.
• Reason this comment was not posted:
  Confidence changes required: 50%
  The error message should be more descriptive to help with debugging.

Workflow ID: wflow_DbQdwxicefmDSX6g

---

You can customize Ellipsis with 👍 / 👎 feedback, review rules, user-specific overrides, quiet mode, and more.