mcpField
M
Mcp_server

Mcp_server

本地服务
github.com/hfhfn开发工具535 周前更新

关于 Mcp_server

Mcp_server 是面向 MCP 开发者的 Python 启动与配置参考,介绍如何用 uv 或 uvx 运行服务脚本,并配置 stdio、SSE 和 Streamable HTTP 连接。

主要功能

  1. 01使用 uv 运行 Python 服务
  2. 02使用 uvx 启动服务脚本
  3. 03提供 SSE 与 HTTP 路径示例
  4. 04展示多种传输配置
  5. 05说明 stdio 启动参数

适用场景

  1. 01用 uv 或 uvx 启动 MCP 服务
  2. 02设置客户端的 stdio 连接
  3. 03配置 SSE 或 Streamable HTTP 地址

MCP 相关

该项目提供 MCP 服务运行方式和客户端连接配置示例,涵盖 stdio、SSE 与 Streamable HTTP。

配置

本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。

README 原文English

来自项目 README

README 暂无中文译文,以下为英文原文;中文介绍见上方。

使用uv管理python环境
  • uv启动mcp服务的python脚本
uv run --with mcp[cli] mcp run path/to/mcp.py
  • uvx启动mcp服务的python脚本
uvx --with pillow --with mcp[cli] fastmcp run path/to/mcp.py
启动单个mcp服务 sse和streamable-http两种模式的URL路径
# sse 模式
http://127.0.0.1:8000/sse  # 默认8000端口
http://host.docker.internal:8000/sse  # docker容器内访问
# streamable-http 模式
http://127.0.0.1:8000/mcp  # 默认8000端口
http://host.docker.internal:8000/mcp  # docker容器内访问
使用mcp工具的多种基本配置示例参考:
// 涉及3种模式:stdio,sse,streamable_http
{
  // streamable_http模式
  "mcpServers": {
    "math": {
      "transport": "streamable_http",
      "url": "http://127.0.0.1:8000/mcp"
    },
    // sse模式
    "weather": {
      "transport": "sse",
      "url": "http://127.0.0.1:8000/sse"
    },
    "12306-mcp": {
      "type": "sse",
      "url": "https://mcp.api-inference.modelscope.cn/sse/76ee2dbba8d74f"
    },
    "sequentialthinking": {
      "headers": {
        "Accept": "application/json, text/event-stream",
        "Authorization": "Bearer 0e51a8cd-e77f-072ec3f3d161"
      },
      "url": "https://mcp.api-inference.modelscope.cn/sse/bb19488b5bc049"
    },
    // 本地服务 stdio模式
    "quickchart-server": {
      "isActive": true,
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "-y",
        "@gongrzhe/quickchart-mcp-server"
      ],
      "name": "quickchart-server"
    },
    "excel-mcp-server": {
      "isActive": true,
      "command": "cmd",
      "args": [
        "/c",
        "npx",
        "--yes",
        "@zhiweixu/excel-mcp-server"
      ],
      "env": {
        "LOG_PATH": "C:\\Users\\username\\Desktop\\temp",
        "CACHE_MAX_AGE": "1",
        "CACHE_CLEANUP_INTERVAL": "4",
        "LOG_RETENTION_DAYS": "7",
        "LOG_CLEANUP_INTERVAL": "24"
      },
      "name": "excel-mcp-server"
    }
  }
}

STDIO 模式启动说明

如果需要在客户端以 stdio 模式启动本项目:

  1. 环境准备: 在项目根目录下运行以下命令,安装 MCP 命令行工具:
uv add "mcp[cli]"
  1. 启动配置: 在配置客户端时,使用 uv 作为命令,并配合 --directory 参数指定项目路径。
    • 命令: uv
    • 参数: ["--directory", "/Users/hfhfn/charmProjects/mcp_server/", "run", "main.py"]

评论

支持 Markdown

第一次接触 MCP?

从协议是什么,到在客户端里装上第一个服务,这几条回答覆盖了大多数入门问题。

一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。