MCP使用经验备忘

MCP启动不起来

MCP启动总是报MCP启动失败，找了很久，才发现，BUN程序在C盘，权限被限制了，只能启动CHERRY studio的时候，以管理员启动就好了

MCP 报错排查

可以激活VENV，然后使用UV 运行命令，排查问题。

MCP 如果报错缺少module

可以使用：UV add 包名

本地sever开发的调试工具：npx @modelcontextprotocol/inspector <command> <arg1> <arg2>

在 Cherry Studio中node起用不了

将NODE的全部路径命令填到命令行里

初始化

PYTHON

为我们的项目创建一个新 directory
uv init weather
cd weather

创建 virtual environment 并激活它
uv venv
.venv\Scripts\activate

安装 dependencies
uv add mcp[cli] httpx

创建我们的 server file

new-item weather.py

引入依赖
from mcp.server.fastmcp import FastMCP

初始化 FastMCP server

mcp = FastMCP("weather")

node

为我们的项目创建一个新 directory
md weather
cd weather

初始化一个新的 npm 项目
npm init -y

安装 dependencies
npm install @modelcontextprotocol/sdk zod
npm install -D @types/node typescript

创建我们的 files
md src
new-item src\index.ts

package.json

{
"type": "module",
"bin": {

"weather": "./build/index.js"

},
"scripts": {

"build": "tsc && chmod 755 build/index.js"

},
"files": [

"build"

],

}

tsconfig.json

{
"compilerOptions": {

"target": "ES2022",
"module": "Node16",
"moduleResolution": "Node16",
"outDir": "./build",
"rootDir": "./src",
"strict": true,
"esModuleInterop": true,
"skipLibCheck": true,
"forceConsistentCasingInFileNames": true

},
"include": ["src/*/"],
"exclude": ["node_modules"]

}