1. MCP是什么

概念

MCP（模型上下文协议 /Model Context Protocol）是一套让AI可以连接外部工具增强其能力的开放标准。

像 USB‑C 为电子设备的连接提供了标准化方式一样，MCP 为 AI 应用与外部系统的连接提供了标准化方式。

好处

降开发复杂度、扩 AI 应用能力、提升用户体验、生态广泛兼容、一次构建通用

架构

角色	通俗理解	对应你现在的场景
MCP servers	「工具 / 数据提供者」，提供标准接口	你配置的 GitHub、PostgreSQL、自定义脚本这些 MCP 服务
MCP clients	「AI 客户端」，连接服务器、给模型用	你用的 Claude Code / Claude Desktop

2. mcp相关命令

2.1 命令汇总

命令	作用	语法与示例
claude mcp add	添加 MCP 服务器	基础：claude mcp add --transport <类型> <名称> <URL> HTTP：claude mcp add --transport http notion https://mcp.notion.com/mcp
claude mcp add-json	用 JSON 配置添加服务器	claude mcp add-json <名称> '<JSON配置>' [--client-secret]
claude mcp list	列出所有已配置服务器	claude mcp list
claude mcp get	查看服务器详情	claude mcp get <服务器名称> 示例：claude mcp get github
claude mcp remove	删除服务器	claude mcp remove <服务器名称> 示例：claude mcp remove sentry
claude mcp help	查看mcp命令帮助	claude mcp add --help

参数配置

参数	适用场景	说明	示例
–transport	必选	指定服务器传输类型：http/sse/stdio	--transport stdio
–scope	所有	配置作用域：local（默认，项目私有）/project（团队共享）/user（跨项目）	--scope project
–env	stdio / 本地	传递环境变量	--env DB_URL=postgresql://...
–help	任意	查看命令帮助	claude mcp add --help

Claude Code的MCP文档

2.2 添加MCP

添加MCP有三种方式

• HHT远程MCP服务 ：每次调用工具都要重新建连接，适合简单一次性工具。
• SSE远程MCP服务：建立一次长连接，服务器可以主动推送事件。
• STDIO 本地MCP服务：本地部署的mcp服务调用

添加mcp后需要重启claude code

添加HTTP远程MCP服务

# 基础语法 hhtp服务
claude mcp add --transport http <name> <url>

# 使用http方式添加notion 一款超级火的「笔记 + 知识库 + 协作办公」软件
claude mcp add --transport http notion https://mcp.notion.com/mcp

#  使用http方式添加需要授权的Apifox  一个接口文档，调试，mock，自动化测试的工具
claude mcp add --transport http apifox https://mcp.apifox.com/mcp \
  --header "Authorization: Bearer your_apifox_token" \
  --header "X-Project-ID: your_project_id"

添加SSE远程MCP服务

# 基础语法 sse 服务
#claude mcp add --transport sse <name> <url>

# 使用sse方式添加Figma（UI 设计，最常用）需要收手动授权
claude mcp add --transport sse figma https://mcp.figma.com/sse

# 使用sse方式添加需要授权linear （任务管理，程序员必备）
claude mcp add --transport sse linear https://mcp.linear.app/sse \
  --header "Authorization: Bearer 你的LinearToken"

添加本地MCP服务

# 基础语法
claude mcp add [options] <name> -- <command> [args...]

# 添加本地 FastMCP 服务（stdio 模式，正确用法）
claude mcp add my-fastmcp --scope user -- python /绝对路径/你的/my_server.py

2.3 MCP作用域名

范围。	生效范围	储存位置（JSON 文件）
用户--scope user	所有项目	~/.claude.json 的mcpServers字段下
当地的---scope local	仅当前项目	~/.claude.json的项目目录下的mcpServers
项目--scope project	仅当前项目	项目目录内：.mcp.json

3. 自定义MCP

本示例做基于python做一个本地的MCP服务，查询开发者信息接口

3.1 MCP服务创建

需要安装 fastMCP

npm install fastmcp

# FastMCP python提供的最简单的创建MCP框架
from fastmcp import FastMCP

from datetime import datetime

# 1. 创建 MCP Server 实例
server = FastMCP("my-python-mcp-server")

# 2. 定义工具：查询开发者信息
# @server.tool()将普通函数装饰成MCP (自动抓取函数名、参数、描述)生成对应的MCP 服务相关信息
@server.tool()
async def queryDeveloper() -> str:
    """
     查询开发者信息（很重要）
     [Args:参数描述]
     [Returns:返回值描述]
    """
    print("打印日志操作")
    return f"我是一个java开发者，叫我xiu吧，我正在学习Claude Code 编程"

# 4. 启动 MCP Server
if __name__ == "__main__":
    #标准stdio模式
    server.run()
    #Http模式
    server.run(transport="http",port=1035)

原理介绍：

1. 服务实例化：FastMCP("服务名") 创建服务实例，会自动生成 MCP 协议标准的通信接口。

2. 工具注册：@server.tool() 装饰器会自动抓取函数名、描述、参数，生成 Claude 可识别的工具元数据
   (描述信息要好好写这是模型能正确识别并调用工具的基础)。

3. 启动通信：server.run() 以 stdio 模式启动服务，通过标准输入 / 输出和 Claude Code 建立双向通信，Claude 会通过 MCP 协议自动发现并调用你的工具。

http形式启动MCP服务效果图

3.2 claude code配置MCP

#使用claude mcp add方式 当前用户维度MCP
#本地方式注册(用python直接执行)
claude mcp add my-python-mcp-server \
  --scope user \
  -- python "$HOME/PycharmProjects/xiu_lang_graph/mcp/xiu_mcp_server.py"
 
#远程方式注册（FastMCP的HTTP模式=自动SSE模式）
claude mcp add my-http-mcp-server \
  --transport http \
  --scope user  \
  http://127.0.0.1:1035/mcp 
  
#重新启动Claude code  

STDIO模式安装效果图

HTTP模式安装效果

3.3 使用自定义的mcp

# 查看可用的mcp服务 主要其描述信息
mcp                                                                                                            

上图我目前有安装了2个MCP

1. 远程的Figma(程序设计使用)
2. 本地的python写的自定义的MCP服务

claude code 调用自定义mcp

原理介绍：

1. Claude 先拉取所有 MCP 工具

listTools() → 获取所有工具名、描述、参数

2. 把工具列表塞进提示词（Prompt）

你是一个AI助手，可用工具：
1. queryDeveloper() → 查询开发者信息
2. add(a,b) → 加法计算
3. getWeather(city) → 获取天气
当用户提问时，请决定是否使用工具。

3. 模型根据工具描述 + 用户问题做选择

用户问“帮我查询开发者信息”
→ 匹配工具描述“查询开发者信息”
→ 选择调用 queryDeveloper()

4. 编程开发相关MCP

4.1 MCP平台

名称	网址	简要介绍
mcp.so	https://mcp.so/	全球最大的 MCP 资源聚合平台，收录超过 8000 个 MCP 服务器，提供丰富的搜索和筛选功能。
PulseMCP	https://www.pulsemcp.com/	收录了大量的 MCP Servers 和 Clients，为用户提供了一个全面的 MCP 生态系统信息枢纽。
MCP Market	https://mcpmarket.cn/	提供 23,162 个 MCP 服务器的集合，支持全球 MCP 服务器的发现与连接，覆盖多个应用领域。
Awesome MCP Servers	https://mcpservers.org/	精选列表，虽然收录的 MCP Server 数量不多，但都是经过筛选的高质量资源。
GitHub-MCP 官方项目	https://github.com/	Anthropic 官方维护的 MCP 资源库，提供官方推荐的 MCP Servers 及第三方贡献。

4.2 常用MCP

MCP 名称	作用	Claude Code 安装命令
playwright	浏览器自动化：打开网页、截图、抓取内容、模拟操作	claude mcp add playwright --scope user -- npx @playwright/mcp@latest
context7	提供最新官方 API 文档，让 Claude 不生成过时代码	claude mcp add context7 --transport https --scope user https://mcp.context7.com/mcp
markdown	Markdown 解析、渲染、目录生成、文档处理	claude mcp add markdown --scope user -- npx @un-markdown/mcp-server
ext	Claude Code 扩展工具集（文件 / 系统 / 交互增强）	claude mcp add ext --scope user -- uvx git+https://github.com/ ...
devdocs	海量开发文档查询（Python/Java/Go/JS 等）	claude mcp add devdocs --scope user -- npx @modelcontextprotocol/devdocs-mcp
sequentialthinking	让 Claude 分步思考、规划任务、逻辑推理	claude mcp add sequentialthinking --scope user -- npx @modelcontextprotocol/sequentialthinking
filesystem	本地文件读写、搜索、批量操作、目录管理	claude mcp add filesystem --scope user -- npx @modelcontextprotocol/filesystem
github	GitHub 仓库管理、PR/Issue/ 代码搜索	claude mcp add github --scope user -- npx @modelcontextprotocol/github-mcp
githubstars	管理 GitHub Star 项目、搜索、分类	claude mcp add githubstars --scope user -- npx @modelcontextprotocol/github-stars-mcp
puppeteer	无头浏览器自动化（网页抓取、截图）	claude mcp add puppeteer --scope user -- npx @modelcontextprotocol/puppeteer-mcp
fetch	网络请求：GET/POST，调用接口、爬取网页	claude mcp add fetch --scope user -- npx @modelcontextprotocol/fetch-mcp
sql	数据库查询、执行 SQL、查看表结构	claude mcp add sql --scope user -- npx @modelcontextprotocol/sql-mcp
websearch	联网搜索、获取实时信息、最新资料	claude mcp add websearch --scope user -- npx @modelcontextprotocol/websearch-mcp