自定义 MCP 服务器

一个集成多种工具的自定义机器对话协议（MCP）服务器，用于 AI 助手：

• Brave 搜索 - 网页和本地搜索功能
• 安全文件系统 - 带有安全控制的文件操作
• GitHub 集成 - 仓库和代码管理
• 顺序思考 - 分步解决问题
• 下载工具 - 从互联网下载文件

快速开始

# 克隆仓库
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

使用 Claude

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

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

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

架构

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

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 中的路由

测试

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

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

文档

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

许可证

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