Brave Search MCP 服务器

想象一下，你正在为你的AI助手配置各种能力，比如让它能安全地读写你电脑上的文件、操作Git仓库、甚至是访问PostgreSQL数据库。你不需要从零开始编写这些代码，也不需要到处寻找第三方的实现。你只需要来到一个地方，复制几行配置，你的AI就立刻拥有了这些强大的工具。这正是官方的servers仓库所做的事情。

servers仓库是模型上下文协议的官方参考实现集合。它由协议维护团队直接管理，提供了多个高质量、标准化的MCP服务器实现，并有详细的文档和示例。无论你是想为自己的AI客户端增加实用功能，还是想学习如何构建自己的MCP服务器，这个仓库都是你的第一站。

项目基本信息

一、项目介绍

servers仓库是MCP生态系统的核心组成部分。它是一个精心策划的集合，包含了两大类资源：

第一类是官方参考服务器。这些服务器由MCP指导小组维护，旨在作为教学示例，展示如何使用MCP SDK构建不同类型的服务器。它们涵盖了许多通用场景，例如文件系统操作、Git仓库交互、网页内容抓取、知识图谱记忆等。虽然它们被明确标记为“非生产环境就绪”，但它们的代码质量高、注释清晰，是开发者学习MCP服务器开发的最佳教材。

第二类是生态系统索引。仓库中维护着一个庞大的社区资源和框架列表。你可以在这里找到几乎所有主流编程语言（从Python、TypeScript到Go、Rust、PHP等）的MCP SDK和框架。此外，它还索引了大量第三方MCP服务器、管理工具、客户端和教程资源，是整个MCP世界的导航图。

值得注意的是，随着MCP生态的快速发展，官方已经将第三方服务器的列表职责移交给了更专业的MCP Registry。因此，这个仓库现在更加聚焦于其核心使命：维护高质量的参考实现，并作为生态资源的索引门户。

二、核心优势

官方权威，质量保证：作为MCP协议的官方仓库，这里的参考服务器由协议维护者直接编写和审核。它们严格遵循MCP规范，展示了最佳实践。对于想理解“正确的MCP服务器应该怎么写”的开发者来说，没有比这更权威的来源了。

一书在手，天下我有：这个仓库是一个微型的MCP生态中心。你不仅能找到官方的参考实现，还能发现几乎所有社区贡献的SDK、框架、客户端和管理工具。无论是寻找某个特定功能的服务器，还是想了解当前MCP生态的全貌，这里都是理想的起点。

参考价值极高：每个参考服务器都精心设计，以突出MCP的某个特定方面。例如，Everything服务器是一个测试工具，展示了提示、资源和工具三大核心原语；Fetch服务器专注于网页内容的高效获取；Memory服务器则实现了一个基于知识图谱的持久记忆系统。通过这些具体的例子，你可以直观地理解MCP的抽象概念。

开箱即用的便利性：仓库中的所有TypeScript和Python服务器都可以通过npx或uvx命令直接运行，无需克隆代码或手动安装依赖。这使得在Claude Desktop等客户端中配置和使用这些服务器变得异常简单，通常只需要在配置文件中添加几行JSON。

三、适用场景

场景一：为你的AI客户端快速添加实用功能。这是最直接的应用场景。通过配置官方参考服务器，你可以让你的Claude Desktop或Cursor立刻拥有以下能力：

• 使用@modelcontextprotocol/server-filesystem让AI安全地读写你指定的目录
• 使用mcp-server-git让AI克隆仓库、查看提交历史、创建分支
• 使用@modelcontextprotocol/server-memory让AI拥有跨会话的持久记忆
• 使用@modelcontextprotocol/server-time让AI进行时间查询和时区转换

场景二：学习MCP服务器开发的标准范式。如果你是开发者，想为MCP生态贡献自己的力量，这个仓库是必读的。你可以研究src/目录下每个服务器的实现，学习如何组织代码、如何处理工具调用、如何管理资源。官方SDK的使用方法在这里得到了最规范的展示。

场景三：探索MCP生态，发现社区资源。当你需要解决某个特定问题（例如构建一个Slack机器人、集成Google Drive）时，可以在这个仓库的资源列表中找到相关的社区项目和框架。它也列出了像Smithery、mcp-get这样的管理工具，以及各种语言的SDK，帮助你更快地找到合适的工具。

场景四：安全评估与尽职调查。由于官方服务器是参考实现，它们经过了社区的安全审查。你可以基于这些实现来评估自己构建的系统安全性。同时，仓库明确指出了每个服务器的定位（非生产就绪），这有助于你做出正确的技术选型。

四、安装教程

由于这是一个仓库集合，并非单一的服务器，因此没有统一的安装步骤。下面以最常用的Filesystem服务器为例，演示如何配置到Claude Desktop中。

第一步：找到你的Claude Desktop配置文件

• macOS: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

第二步：添加服务器配置

使用文本编辑器打开该文件，在mcpServers对象中添加以下内容。注意，你需要指定一个允许Filesystem服务器访问的目录路径，例如/Users/你的用户名/Documents。

{
  "mcpServers": {
    "filesystem": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-filesystem", "/Users/你的用户名/Documents"]
    }
  }
}

Windows用户请注意，需要将命令包装一下：

{
  "mcpServers": {
    "filesystem": {
      "command": "cmd",
      "args": ["/c", "npx", "-y", "@modelcontextprotocol/server-filesystem", "C:\\Users\\你的用户名\\Documents"]
    }
  }
}

第三步：重启Claude Desktop

完全退出应用并重新启动。现在，你可以尝试让AI读取你Documents目录下的一个文件，例如：“请帮我列出我的Documents文件夹里有哪些文件。”

配置Memory服务器示例

{
  "mcpServers": {
    "memory": {
      "command": "npx",
      "args": ["-y", "@modelcontextprotocol/server-memory"]
    }
  }
}

配置Git服务器示例

注意：Git服务器是Python实现，需要使用uvx。

{
  "mcpServers": {
    "git": {
      "command": "uvx",
      "args": ["mcp-server-git", "--repository", "/完整/路径/到/你的/git/仓库"]
    }
  }
}

五、使用示例

配置好服务器后，你就可以在对话中使用这些强大的工具了。以下是每个参考服务器的典型用法。

Filesystem服务器示例

你问：“请读取我的文档目录下的‘project-plan.md’文件，然后总结一下其中的主要里程碑。”

AI会调用read_file工具（如果已实现），读取指定路径的文件内容，然后进行总结。

你问：“在我的下载文件夹里新建一个名为‘test’的文件夹。”

AI会调用create_directory工具，在授权的目录下执行创建操作。

Memory服务器示例

你问：“记住，我是一名专注于人工智能的软件工程师。”

AI会调用create_entities工具，将这个事实存储到知识图谱中。下次对话时，如果你问“我是谁？”，AI能基于记忆回答。

你问：“我和‘MCP协议’之间是什么关系？”

AI会查询知识图谱，分析节点之间的关系，然后回答你可能正在学习或研究MCP协议。

Git服务器示例

你问：“帮我查看一下当前仓库最近3次的提交记录。”

AI会调用git_log工具，返回提交历史。

你问：“创建一个名为‘feature/new-ui’的新分支，并切换过去。”

AI可以执行git_checkout或git_branch工具，完成分支操作。

Fetch服务器示例

你问：“请抓取‘https://modelcontextprotocol.io’这个网站的内容，然后用中文总结一下MCP是什么。”

AI会调用fetch工具，读取网页的干净内容，然后基于全文回答。

六、常见问题

问题一：我按照配置添加了服务器，但Claude Desktop提示找不到npx命令。

解决方案：这通常意味着Node.js未正确安装或未添加到系统PATH。请确保你已安装Node.js 18或更高版本，并能在终端中运行npx --version。如果不行，请重新安装Node.js，并勾选“添加到PATH”选项。安装后重启电脑，再重启Claude Desktop。

问题二：Filesystem服务器提示权限错误，无法读写文件。

解决方案：Filesystem服务器的设计是安全的，它只能访问你在配置中明确指定的目录及其子目录。请检查你的配置，确保路径正确无误。如果你要访问的文件夹不在该路径下，你需要修改配置，将其添加到参数列表中，例如：args: ["-y", "@modelcontextprotocol/server-filesystem", "/path/to/folder1", "/path/to/folder2"]。

问题三：Git服务器提示找不到Git仓库。

解决方案：配置Git服务器时，--repository参数需要指向一个已经初始化的Git仓库的根目录（即包含.git文件夹的目录）。请确认路径正确，并且该目录确实是一个有效的Git仓库。你可以先在终端中进入该目录，运行git status测试一下。

问题四：Memory服务器的记忆是永久保存的吗？

解决方案：Memory服务器默认将知识图谱数据存储在本地文件中。这意味着在你关闭Claude Desktop并重新打开后，之前的记忆仍然存在。如果你希望重置记忆，可以删除服务器生成的数据文件。具体的文件位置取决于服务器的实现，通常会在项目文档中说明。

问题五：这些官方服务器可以在生产环境中使用吗？

解决方案：官方明确说明这些服务器是参考实现，主要用于教学和演示目的，不建议直接用于生产环境。在生产环境中，你需要根据自己的安全需求、性能要求和业务逻辑，构建定制化的服务器。不过，你可以将官方服务器的代码作为坚实的基础，进行修改和增强。

七、总结

servers仓库是整个MCP生态的基石和灯塔。它不仅仅是一个代码仓库，更是一个学习中心、一个资源导航和一个质量标杆。作为官方项目，它有着无与伦比的权威性和可信度。

对于普通用户，它是为AI客户端快速添加实用功能的最便捷途径。通过简单的配置，你的AI就能获得操作文件、管理Git、持久记忆等诸多能力。对于开发者，它是学习MCP服务器开发的最佳教材，每一行代码都体现了官方的最佳实践。对于整个社区，它维护着庞大的生态资源索引，让每个人都能轻松找到所需的信息和工具。

这个仓库的活跃度令人惊叹——超过8.4万颗星、800多位贡献者、4000多次提交，这足以证明MCP生态的蓬勃生机。无论你是MCP的新手还是老手，无论你是使用者还是开发者，servers仓库都应该是你浏览器书签中最重要的一个。

如果你还没有探索过这个宝藏仓库，现在就是最好的时机。去为你的AI助手解锁文件系统访问、Git操作、持久记忆等神奇能力吧。你一定会惊讶于，几行配置能给AI带来的巨大改变。