本文由 AI (Kiro + Claude Opus 4.6) 生成。

MCP 是什么

MCP（Model Context Protocol）是 Anthropic 发起的开放标准，2025 年底捐赠给了 Linux 基金会。它让 AI 助手能够连接外部工具和数据源——不只是给建议，而是真正去操作 GitHub、查数据库、读文档、转文件。

可以把它理解为 AI 的”USB-C 接口”：一端是各种工具，另一端是 AI 客户端。一个 MCP 服务器可以同时被 Kiro、Cursor、Claude Desktop 等多个客户端使用。

我在用的 MCP

以下是我实际配置并在用的 MCP 服务器，按实用程度排序。

GitHub MCP

最基础也最常用的一个。让 AI 直接操作 GitHub 仓库：管理 commits、PR、issues、分支，搜索仓库和用户。

{
  "github": {
    "command": "npx",
    "args": ["-y", "@modelcontextprotocol/server-github"],
    "env": {
      "GITHUB_PERSONAL_ACCESS_TOKEN": "你的Token"
    }
  }
}

Token 在 GitHub Settings → Developer settings → Personal access tokens 创建，勾选 repo 权限即可。

⚠️ 注意：创建 Token 时推荐选择 Classic Token，而不是 Fine-grained Token。Fine-grained Token 目前对部分 MCP 操作的权限支持不够完整，可能导致某些 API 调用失败。

Context7

Context7 解决 AI 训练数据过时的问题。它实时从官方文档源拉取最新的、版本匹配的文档和代码示例，注入到你的 prompt 中。GitHub 30000+ stars，Upstash 团队维护。

使用时在提问中加 “use context7”：

Astro Content Collections 怎么定义 schema？use context7

{
  "context7": {
    "command": "npx",
    "args": ["-y", "@upstash/context7-mcp@latest"],
    "env": {},
    "disabled": false
  }
}

不需要 API key，免费公共模式直接可用。

Notion MCP

Notion 官方 MCP，支持 22 个工具，覆盖搜索、创建、编辑页面和数据库。如果你用 Notion 管理笔记或项目，这个很实用。

配置前需要：

1. 去 Notion Integrations 创建 Internal Integration，拿到 token
2. 在 Notion 中把目标页面连接到这个 Integration

{
  "notionApi": {
    "command": "npx",
    "args": ["-y", "@notionhq/notion-mcp-server"],
    "env": {
      "NOTION_TOKEN": "你的token"
    }
  }
}

Notion 也推出了远程版 MCP（通过 OAuth 认证），不需要手动配 token，但本地版目前功能更完整。

MarkItDown

markitdown-mcp-npx 是基于微软 MarkItDown 库的万能格式转 Markdown 工具，支持：

• PDF、DOCX、XLSX、PPTX
• 图片（带元数据）、音频（带转录）
• 网页、YouTube 视频字幕

{
  "markitdown": {
    "command": "npx",
    "args": ["-y", "markitdown-mcp-npx"],
    "env": {}
  }
}

⚠️ 这个 MCP 踩坑较多，记录如下：

前置依赖：Python 3.10+

虽然用 npx 启动，但底层是 Python 库。启动时会自动在临时目录创建虚拟环境并安装依赖（约 100MB+）。没有 Python 会直接报错。

Windows 安装 Python：winget install Python.Python.3.13

首次启动超时

首次运行需要下载大量 Python 依赖，耗时较长。Kiro 对 MCP 服务器启动有超时限制，很可能在依赖装完之前就断开连接，显示 Connection Failed。

解决办法：先在终端手动跑一次 npx -y markitdown-mcp-npx --help，等依赖全部安装完成后，再在 Kiro MCP 面板点 Retry。后续启动就是秒连。

虚拟环境损坏

如果首次安装中途被打断（超时、关闭终端等），会留下不完整的虚拟环境，再次启动时报权限错误 Permission denied: python.exe。

解决办法：删除临时目录后重试：

Remove-Item -Recurse -Force "$env:TEMP\markitdown-mcp-npx"

JSON 中 Windows 路径的反斜杠

如果需要在 env 中配置 PATH，Windows 路径的 \ 在 JSON 里必须转义为 \\，否则会导致整个 mcp.json 解析失败，所有 MCP 服务器都会消失。实际上如果 Python 已在系统 PATH 中，不需要额外配置 env。

值得关注的其他 MCP

除了我在用的，以下这些也值得根据需求选装：

在 Kiro 中配置 MCP

Kiro 的 MCP 配置文件有两个层级：

• 用户级（全局）：~/.kiro/settings/mcp.json
• 工作区级（项目专属）：.kiro/settings/mcp.json

工作区配置会覆盖用户级配置。一般把通用的（Context7、Markdownify）放用户级，项目相关的（GitHub）放工作区级。

修改配置后 Kiro 会自动重连 MCP 服务器，不需要重启。

参考

• Kiro 官方文档 - MCP
• MCP 官方规范
• Awesome MCP Servers