自定义 MCP 服务器

一个自定义的机器对话协议 (MCP) 服务器，集成了各种用于 AI 助手的工具：

• Brave 搜索 - Web 和本地搜索功能
• 安全文件系统 - 具有安全控制的文件操作
• 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 一起使用

要将此自定义 MCP 服务器与 Claude 一起使用，您需要将其安装为 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 - 执行 Web 搜索
• 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 文件。