AI导哈

MCP服务器

Ultimate MCP Server是一个超简约的HTTP FastMCP v2端点，可与任何MCP兼容客户端配合使用，并支持来自任何提供商的AGI。

  • by grzegorz-aniol
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 grzegorz-aniol/ultimate-mcp

使用说明

终极MCP服务器

Ultimate MCP Server是市场上唯一一款真正开箱即用的AGI就绪MCP服务器，它是一个超小型、仅支持HTTP的FastMCP v2端点，可以插入任何兼容MCP的客户端，并与任何提供商的AGI合作。没有stdio。没有脚手架。将您的客户端指向/mcp，并停用其他所有服务器。一台服务器。所有供应商。毫无疑问。

俏皮的MCP炒作免责声明：这个回购是一个开玩笑的元笑话。在燕尾服下，它故意很小（想想“穿着西装和徽章的回声服务器”）。协议是严肃的；这个回购不是。负责任地使用，自由地模仿。 答案是42。

  • 传输：HTTP（无stdio）
  • 端点路径：/mcp
  • 服务器名称：终极mcp

需求

  • Python 3.13+
  • 紫外线 （推荐）
  • macOS（定制说明；应跨平台工作）

安装

同步依赖关系（FastMCP+MCP SDK已在中声明 pyproject.toml):

uv sync

跑

通过HTTP在localhost:8000上启动服务器：

uv run ultimate-mcp --host 127.0.0.1 --port 8000

这服务于MCP HTTP端点：

  • http://127.0.0.1:8000/mcp

注意：这是一个用于MCP客户端的MCP端点（HTTP/stream上的JSON-RPC），而不是人类可读的页面。

码头工人

构建映像（多阶段、基于uv、Python 3.13-slim运行时）：

docker build -t ultimate-mcp:latest .

运行服务器（在端口8000上公开HTTP SSE，路径/mcp）：

docker run --rm -p 8000:8000 ultimate-mcp:latest
# Endpoint: http://localhost:8000/mcp

通过env或CLI标志配置主机/端口：

# Using env (inside container defaults to host=0.0.0.0, port=8000)
docker run --rm -p 9000:9000 -e MCP_PORT=9000 ultimate-mcp:latest

# Or override command flags
docker run --rm -p 8000:8000 ultimate-mcp:latest --host 0.0.0.0 --port 8000

笔记：

  • 以非root用户身份运行
  • 使用/opt/venv上的供应商虚拟环境
  • 通过uv和uv.lock可复制安装

从MCP兼容客户端使用

光标

配置文件：~/.cursor/mcp.json

{
  "mcpServers": {
    "ultimate-mcp": {
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

克劳德桌面

配置文件（macOS）：~/库/应用程序支持/Claude/Claude_desktop_Config json
（Windows:%APPDATA%\Claude\Claude_desktop_config.json）

Claude Desktop通过mcp-remote连接到远程HTTP/SSE服务器：

{
  "mcpServers": {
    "ultimate-mcp": {
      "command": "npx",
      "args": ["mcp-remote", "http://127.0.0.1:8000/mcp"]
    }
  }
}

参考：modelcontextprotocol.io“连接到本地MCP服务器”

Cline（VS代码扩展）

配置文件（macOS）：~/库/应用程序支持/代码/用户/全局存储/saoudrizwan.claude-dev/settings/cline_mcp_settings.json

{
  "mcpServers": {
    "ultimate-mcp": {
      "url": "http://127.0.0.1:8000/mcp",
      "disabled": false,
      "autoApprove": []
    }
  }
}

参考：GitMCP README“连接临床”

VS代码（副驾驶代理模式）

工作区配置：.vcode/mcp.json
用户配置：使用命令面板“MCP：打开用户配置”

{
  "servers": {
    "ultimate-mcp": {
      "type": "http",
      "url": "http://127.0.0.1:8000/mcp"
    }
  }
}

参考：code.visualstudio.com“在VS code中使用MCP服务器”

风帆冲浪（Codeium）

配置文件：~/.codium/wundurf/mcp_gonfig.json

{
  "mcpServers": {
    "ultimate-mcp": {
      "serverUrl": "http://127.0.0.1:8000/mcp"
    }
  }
}

参考：GitMCP README“连接Windsurf”

MCP检查员（用于测试）

npx @modelcontextprotocol/inspector
  • 传输：SSE/HTTP
  • 网址：http://127.0.0.1:8000/mcp

笔记：

  • 此服务器在/mcp处公开了一个HTTP SSE端点，与支持HTTP/SSE上的mcp的客户端兼容。
  • 对于Claude Desktop，使用如上所示的mcp远程包装器。
  • 如果您的客户端需要身份验证标头，请在其配置中设置它们（默认情况下此服务器不需要）。

通过ngrok在互联网上使用OpenAI平台

将本地MCP服务器暴露到公共HTTPS URL，并将其连接到ChatGPT。

  1. 在本地运行服务器（端口8000）：
uv run ultimate-mcp --host 127.0.0.1 --port 8000
# Local endpoint: http://127.0.0.1:8000/mcp
  1. 安装并验证ngrok（显示macOS；请参阅https://ngrok.com/download对于其他人）：
brew install ngrok
ngrok config add-authtoken <YOUR_NGROK_AUTHTOKEN>
  1. 启动到本地服务器的隧道：
ngrok http 8000
  1. 从ngrok复制HTTPS“转发”URL并附加/mcp，例如：
https://abc123.ngrok-free.app/mcp
  1. 在OpenAI平台上配置聊天以使用此MCP服务器：
  • 在OpenAI平台中，创建一个新的聊天。
  • 选择“添加工具”>“MCP服务器”
  • 选择“+服务器”并粘贴ngrok URL（包括/mcp）
  • 保存。可选择为“always_ask”工具启用自动批准

配置的MCP服务器：

对话：

为克莱恩干杯：

笔记：

  • 除非您使用保留域，否则ngrok URL每次都会更改。更改ChatGPT MCP服务器URL时进行更新。
  • 该端点是基于HTTP/SSE的MCP JSON RPC端点，而不是面向人类的网页。
  • 公司代理/防火墙可能需要允许SSE/长期HTTP连接。

备注

  • 此服务器仅公开HTTP传输；在实现中的任何地方都没有使用stdio传输。
  • 主机/端口可以通过CLI标志或环境变量进行自定义：
    • MCP_HOST/mcpport
    • 或 --host / --port 旗帜

发展

  • 格式和类型提示与Pylance/pyright兼容。
  • 要修改或添加工具，请使用装饰功能 @mcp.tool().FastMCP自动从类型提示和文档字符串中导出JSON模式。

相关 MCP