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. 保持数据更新对于动态数据，考虑采用缓存策略