Custom MCP Server

🚀 自定義 MCP 服務器

一個集成多種工具的自定義機器對話協議（MCP）服務器，專為 AI 助手打造。它能提供豐富的功能，助力 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 配合使用此自定義 MCP 服務器，請將其安裝為 MCP 服務器：

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

安裝完成後，Claude 將能夠訪問該服務器提供的所有功能。

高級用法

可以直接對 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 文件。