Custom MCP Server

🚀 自定义 MCP 服务器

一个集成多种工具的自定义机器对话协议（MCP）服务器，专为 AI 助手打造。它整合了 Brave 搜索、安全文件系统、GitHub 集成等实用功能，能助力 AI 助手更高效地完成各项任务。

🚀 快速开始

# 克隆仓库
git clone https://github.com/degenhero/custom-mcp-server.git
cd custom-mcp-server

# 安装依赖并设置环境
npm run install:all

# 启动两个服务器
npm run start:both

服务器将运行在以下地址：

• MCP 服务器：http://localhost:3000
• MCP 协议服务器：http://localhost:3001

✨ 主要特性

• Brave 搜索：具备网页和本地搜索功能，为信息获取提供便利。
• 安全文件系统：带有安全控制的文件操作，保障文件数据安全。
• GitHub 集成：可进行仓库和代码管理，方便开发协作。
• 顺序思考：能够分步解决问题，提高问题处理的逻辑性。
• 下载工具：支持从互联网下载文件，满足资源获取需求。

💻 使用示例

使用 Claude

要与 Claude 配合使用此自定义 MCP 服务器，请将其安装为 MCP 服务器：

npx @anthropic-ai/install-mcp custom-mcp-server http://localhost:3001

安装完成后，Claude 将能够访问该服务器提供的所有功能。

测试 MCP 服务器

可以直接对 MCP 服务器进行测试：

curl -X POST http://localhost:3000/mcp \
  -H "Content-Type: application/json" \
  -d '{"functionName": "brave_web_search", "parameters": {"query": "test query"}}'

📚 详细文档

架构

该项目由两个主要组件组成：

1. 自定义 MCP 服务器（index.js）：实现所有工具功能的核心服务器。
2. MCP 协议服务器（mcp-protocol.js）：将自定义服务器适配为 MCP 协议标准。

可用功能

Brave 搜索

• brave_web_search - 执行网页搜索
• brave_local_search - 搜索本地企业和地点

文件系统操作

• read_file - 读取文件内容
• write_file - 创建或更新文件
• edit_file - 进行基于行的编辑
• create_directory - 创建目录
• list_directory - 列出目录内容
• 等等...

GitHub 集成

• create_repository - 创建新仓库
• search_repositories - 搜索仓库
• get_file_contents - 读取仓库中的文件
• push_files - 推送文件到仓库
• 等等...

顺序思考

• sequentialthinking - 分步解决问题

下载工具

• download_file - 从 URL 下载文件
• download_multiple_files - 同时下载多个文件

配置

配置通过环境变量在 .env 文件中管理：

PORT=3000                      # 主服务器端口
MCP_PROTOCOL_PORT=3001         # MCP 协议服务器端口
BRAVE_API_KEY=your_key_here    # Brave 搜索的 API 密钥
GITHUB_TOKEN=your_token_here   # GitHub 访问令牌

开发

添加新功能

要添加新功能，需按以下步骤操作：

1. 在 functions 目录中的适当文件中创建处理程序。
2. 将函数定义添加到 mcp-schema.json。
3. 更新 index.js 中的路由。

文档说明

有关所有可用功能的详细文档，请参阅 documentation.md。

📄 许可证

该项目根据 MIT 许可证发布，具体信息请查看 LICENSE 文件。