流式HTTP传输MCP服务器

一个基于流式HTTP传输的MCP服务器实现,用于与MCP客户端进行通信。

  • by The-Cortex-Hub
  • Python
  • 本地部署
  • 更新于
在 GitHub 查看 The-Cortex-Hub/mcp-demo-streamable-http

使用说明

MCP - 可流式传输的HTTP。

这个仓库包含了一个使用可流式HTTP传输的MCP服务器的简单实现。

运行MCP服务器(快速入门)

  1. 创建一个虚拟环境(推荐)并安装依赖项:
python3 -m venv .venv
source .venv/bin/activate

或者,立即行动。

python3 -m venv .venv && source .venv/bin/activate

对于上述的环境设置,您可以使用您喜欢的环境管理工具,比如Conda。 2) 安装依赖项: 从需求文件安装:

pip install -r requirements.txt
  1. 启动服务器
  • streamable-http 交通:
uv run main.py
  1. 检查员 使用MCP检查器测试您的MCP:
npx @modelcontextprotocol/inspector \
  uv \
  --directory path/to/server \
  run \
  package-name \
  args...
  1. 与MCP客户端建立连接。

将此MCP服务器添加到您的MCP客户端的步骤:

当然,这假设你可能已经有其他服务器,也可能没有。如果你已经有其他服务器,那么请添加(或:请进行添加操作) cortexhub_mcp_server 作为额外的钥匙(或密钥)给 mcpServers 对象。

光标配置(示例): .cursor/mcp.json

{
    "mcpServers": {
        "cortexhub_mcp_server_stdio": {
            "command": "uv",
            "args": [
                "--directory",
                "/absolute/path/to/mcp-demo-streamable-http",
                "run",
                "main.py"
            ]
        },
        "cortexhub_mcp_server_http": {
            "url": "http://127.0.0.1:8000/mcp"
        }
    }
}

注替换 /absolute/path/to/ 使用您实际的项目路径。

实施

最佳实践

  1. 保持资源处于闲置状态它们应该返回数据,而不是执行复杂操作
  2. 使用明确的名称资源名称应明确指示其所提供的数据
  3. 详细记录文件包含解释每个资源内容的文档字符串
  4. 优雅地处理错误如果数据无法访问,请返回有用的错误信息
  5. 保持数据更新对于动态数据,考虑采用缓存策略