Custom MCP Server

自定义 MCP 服务

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

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

快速开始

# Clone the repository
git clone https://github.com/degenhero/custom-mcp-server.git
cd custom-mcp-server

# Install dependencies and set up environment
npm run install:all

# Start both servers
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 Search

• 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                      # Port for the main server
MCP_PROTOCOL_PORT=3001         # Port for the MCP protocol server
BRAVE_API_KEY=your_key_here    # API key for Brave Search
GITHUB_TOKEN=your_token_here   # GitHub access token

开发

添加新功能

要添加新功能：

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 文件。