使用说明

项目简介

本仓库 'mcp-servers-config' 提供了多个基于 Model Context Protocol (MCP) 的服务器配置,旨在扩展 Cursor IDE 这款代码编辑器的 AI 助手功能。通过配置和运行这些 MCP 服务器,Cursor IDE 的 AI 助手可以连接到不同的服务,例如 Notion, GitHub 和 Brave Search,从而实现更强大的辅助编程能力。

主要功能点

  • Notion 集成: 通过 Notion MCP 服务器,AI 助手可以访问和操作 Notion 知识库,例如查询页面、数据库、创建笔记等。
  • GitHub 集成: 通过 GitHub MCP 服务器,AI 助手可以访问和管理 GitHub 仓库,例如搜索代码、查看文件、提交代码等。
  • Brave 搜索集成: 通过 Brave 搜索 MCP 服务器,AI 助手可以进行网页搜索和本地文件搜索,快速获取所需信息。
  • 可扩展性: 仓库结构清晰,易于添加和配置新的 MCP 服务器,方便用户根据自身需求扩展 AI 助手的功能。

安装步骤

  1. 克隆仓库

    git clone https://github.com/u10-github/mcp-servers-config.git
    cd mcp-servers-config
  2. 配置 API 密钥

    • 进入你想要使用的 MCP 服务器的目录,例如 'notion-server' 或 'github-server'。
    • 查找该目录下的 'README.md' 文件或脚本文件 (如 'run-notion.js', 'run-github.js'),根据说明配置所需的 API 密钥。通常需要创建 '.env' 文件并将 API 密钥写入其中,或者设置相应的环境变量。 例如,Notion 服务器需要 'NOTION_API_TOKEN',GitHub 服务器需要 'GITHUB_PERSONAL_ACCESS_TOKEN'。
  3. 安装依赖 (如果需要)

    • 某些 MCP 服务器可能依赖于特定的 npm 包。如果服务器目录中包含 'package.json' 文件,可能需要在该目录下运行 'npm install' 或 'yarn install' 安装依赖。 请参考各个服务器目录下的说明。

服务器配置 (以 Notion MCP Server 为例)

在 Cursor IDE 中配置 Notion MCP Server,你需要添加一个新的 Custom MCP Server,并填写以下配置信息:

{
  "serverName": "Notion MCP Server",
  "command": "node",
  "args": [
    "path/to/mcp-servers-config/notion-server/run-notion.js"
  ]
}

配置信息说明:

  • 'serverName': 自定义服务器名称,例如 "Notion MCP Server",在 Cursor IDE 中用于识别和管理该服务器。
  • 'command': 启动服务器的命令,这里是 'node',表示使用 Node.js 运行时环境来执行脚本。
  • 'args': 命令参数,是一个字符串数组,用于指定服务器启动脚本的路径。 请将 'path/to/mcp-servers-config' 替换为你克隆仓库的本地绝对路径。 例如,如果你的仓库克隆在 'C:/dev/mcp-servers-config',则 'args' 应该配置为 '["C:/dev/mcp-servers-config/notion-server/run-notion.js"]' (Windows) 或 '["/path/to/mcp-servers-config/notion-server/run-notion.js"]' (macOS/Linux)。

其他服务器配置:

GitHub MCP Server 和 Brave Search MCP Server 的配置方式类似。请参考仓库 'README.md' 或各个服务器目录下的说明,获取对应的 'command' 和 'args' 配置信息。 主要区别在于 'args' 参数需要指向相应的服务器启动脚本 (例如 'github-server/run-github.js', 'brave-server/run-brave.js',请根据实际仓库目录结构调整)。

基本使用方法

  1. 确保在 Cursor IDE 的设置中添加并启动了所需的 MCP 服务器。
  2. 在 Cursor IDE 中使用 AI 助手功能时,你可以通过自然语言指令来调用这些 MCP 服务器提供的功能。 例如:
    • 你可以让 AI 助手 "在 Notion 中创建新的待办事项" 或 "搜索 GitHub 仓库中关于 '深度学习' 的代码"。
    • 具体的指令取决于各个 MCP 服务器提供的工具和 Cursor IDE AI 助手的理解能力。

注意:

  • 配置 'args' 参数时,请务必使用仓库在本地的绝对路径,以确保 Cursor IDE 能够正确找到并执行服务器启动脚本。
  • 部分 MCP 服务器可能依赖于第三方 npm 包,启动前请确保已安装必要的依赖。
  • 配置 API 密钥时,请参考各个服务器的说明文档,并妥善保管你的密钥信息。

信息

分类

开发者工具