Skip to content

1.Chatppt MCP Server (Python)

1.1 本地模式(uv)

依赖MCP Python SDK开发,任意支持 MCP 协议的智能体助手(如ClaudeCursor等)都可以快速接入

1.1.1 搭建 Python 虚拟环境

我们推荐通过uv构建虚拟环境来运行 MCP server,关于`uv 你可以在这里找到一些说明。

按照官方流程,你会安装Python包管理工具uv。除此之外,你也可以尝试其他方法(如Anaconda)来创建你的Python虚拟环境。

通过uv添加mcp依赖

Bash
uv add "mcp[cli]"

验证 mcp 依赖是否安装成功,执行如下命令

Bash
uv run mcp

当出现下图时代表安装成功

img

通过uv安装python,最低版本要求为 3.11

Bash
uv python install 3.11

1.2.1 获取 MCP Server

访问 github,获取 chatppt-mcp 项目代码。

暂时无法在飞书文档外展示此内容

1.3.1 配置本地项目

通过uv创建一个项目

Bash
uv init mcp_server_chatppt

ppt.py拷贝到该目录下,通过如下命令测试 mcp server 是否正常运行

Bash
uv run --with mcp[cli] mcp run {YOUR_PATH}/mcp_server_chatppt/ppt.py
# 如果是mac,需要加转义符
uv run --with mcp\[cli\] mcp run {YOUR_PATH}/mcp_server_chatppt/ppt.py

如果没有报错则 MCP Server 启动成功。

1.4.1 在 cline 中验证使用

Cursor

打开Cursor配置,在 MCP 中添加 MCP Server

img

文件中添加如下内容后保存

JSON
{
  "mcpServers": {
    "chatppt": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "{YOUR_PATH}/mcp_server_chatppt/ppt.py"
      ],
      "env": {
        "API_KEY": "<YOUR_API_Token>"
      }
    }
  }
}

VS code(cline 插件)

在 VScode 中搜索 cline 插件,并安装

img

打开 cline,并配置 Mcp Server

img

在文件中添加如下内容后保存

JSON
{
  "mcpServers": {
    "chatppt": {
      "command": "uv",
      "args": [
        "run",
        "--with",
        "mcp[cli]",
        "mcp",
        "run",
        "{YOUR_PATH}/mcp_server_chatppt/ppt.py"
      ],
      "env": {
        "API_KEY": "<YOUR_API_Token>"
      }
    }
  }
}

1.2 pip 库模式(UVX 安装远程库)

1.2.1 安装 chatppt-mcp 包

使用uvx安装chatppt-mcp包:

Bash
uvx install "git+https://github.com/YOOTeam/chatppt-mcp.git#subdirectory=python/src"

1.2.2 启动 Server

Bash
uvx run chatppt

1.2.3 将以下配置添加至 MCP Cline 中(如 Cursor)

JSON
{
  "mcpServers": {
    "chatppt": {
      "command": "uvx",
      "args": ["run", "chatppt"],
      "env": {
        "API_KEY": "<YOUR_API_KEY>"
      }
    }
  }
}