标准输入输出MCP服务器

一个使用标准输入输出传输的MCP服务器实现,适用于快速启动和测试MCP协议。

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

使用说明

MCP - 标准输入/输出。

此仓库包含一个使用标准输入/输出传输的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. 启动服务器
  • stdio 交通:
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-stdio",
                "run",
                "main.py"
            ]
        },
        "cortexhub_mcp_server_http": {
            "url": "http://127.0.0.1:8000/mcp"
        }
    }
}

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

实施

最佳实践

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