Copus MCP Server

🚀 Copus MCP 服務器

Copus MCP 服務器是一個基於 MCP（模型上下文協議）的服務器，它能讓 AI 助手從 Copus 搜索並獲取人工精選的內容推薦。

🚀 快速開始

快速啟動（npx）

無需安裝，直接使用 npx 運行：

npx copus-mcp-server

全局安裝

npm install -g copus-mcp-server

然後運行：

copus-mcp-server

本地安裝

npm install copus-mcp-server

✨ 主要特性

Copus 平臺介紹

Copus 是一個人工精選的內容發現平臺，被稱為“互聯網寶藏地圖”。與基於 SEO 的搜索結果不同，Copus 展示的是真實用戶推薦的內容，並解釋了這些內容為何有價值。

每個精選內容包含以下信息：

• 推薦者的個人備註：說明推薦的原因。
• 推薦者資質：表明推薦者有資格推薦該內容的原因。
• 原始來源 URL：被推薦內容的實際鏈接。
• AI 增強元數據：關鍵要點、目標受眾、解決的問題。
• 參與指標：社區的瀏覽量、保存量、評論數。

MCP 服務器的功能

該服務器使 AI 助手能夠訪問 Copus 的精選內容數據庫。與普通搜索結果不同，您的 AI 可以找到：

• 由領域專家審核的工具和資源。
• 該領域從業者推薦的文章。
• 真實用戶認為有價值而分享的小眾優質內容。

兼容的 AI 平臺

此 MCP 服務器可與任何支持模型上下文協議的 AI 平臺配合使用，包括：

• Claude Desktop（Anthropic）
• Claude Code（Anthropic）
• Cursor（AI 代碼編輯器）
• Cline（VS Code 擴展）
• Continue（VS Code/JetBrains 擴展）
• Zed（代碼編輯器）
• 任何其他支持 MCP 的 AI 平臺

📦 安裝指南

快速啟動（npx）

無需安裝，直接使用 npx 運行：

npx copus-mcp-server

全局安裝

npm install -g copus-mcp-server

然後運行：

copus-mcp-server

本地安裝

npm install copus-mcp-server

💻 使用示例

可用工具

search_curations

在 Copus 上搜索人工精選的內容推薦。 參數：

• query（字符串，必需）：搜索關鍵詞。
• limit（數字，可選）：最大結果數（默認值：10，最大值：50）。

返回值：包含精選內容的數組，每個內容包含以下信息：

• 標題和描述。
• 推薦者姓名和簡介。
• 原始來源 URL。
• 類別和關鍵詞。
• 參與指標（瀏覽量、保存量）。

get_curation

獲取特定精選內容的詳細信息。 參數：

• id（字符串，必需）：精選內容的 ID（搜索結果中的 UUID）。

返回值：完整的精選內容詳細信息，包括：

• 推薦者的個人推薦備註。
• 推薦者資質。
• 關鍵要點。
• 目標受眾。
• 該內容解決的問題。
• 完整的參與指標。

示例用例

配置完成後，您可以向 AI 助手提出以下問題：

學習資源

"我想學習 Python，應該查看哪些資源？"

"幫我找到一些推薦的機器學習教程。"

"學習網頁開發的最佳資源有哪些？"

工具與軟件

"設計師推薦哪些用於線框設計的工具？"

"幫我找到一些人們實際使用並推薦的 AI 工具。"

"有什麼好的免費視頻編輯軟件？"

閱讀與內容

"有哪些關於創意寫作的好書推薦？"

"幫我找到人們認為有價值的關於生產力的文章。"

"有哪些推薦的科技時事通訊？"

特定主題

"查找去除水印的工具。"

"人們推薦哪些 Linux 工具？"

"給我展示一些個人成長內容推薦。"

示例響應

當您搜索 "python tutorials" 時，可能會得到以下結果：

{
  "query": "python tutorials",
  "totalResults": 5,
  "results": [
    {
      "id": "abc123...",
      "title": "Real Python - Python Tutorials",
      "description": "Comprehensive Python tutorials covering basics to advanced topics...",
      "originalSource": "https://realpython.com",
      "category": "Technology",
      "curator": "experienced_dev",
      "engagement": {
        "views": 150,
        "saves": 23
      }
    }
  ]
}

📚 詳細文檔

配置

Claude Desktop

將以下內容添加到您的 Claude Desktop 配置文件中：

• macOS：~/Library/Application Support/Claude/claude_desktop_config.json
• Windows：%APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "copus": {
      "command": "npx",
      "args": ["copus-mcp-server"]
    }
  }
}

或者，如果是全局安裝的：

{
  "mcpServers": {
    "copus": {
      "command": "copus-mcp-server"
    }
  }
}

Claude Code

將以下內容添加到您的 Claude Code MCP 設置中：

{
  "mcpServers": {
    "copus": {
      "command": "npx",
      "args": ["copus-mcp-server"]
    }
  }
}

Cursor

將以下內容添加到您的 Cursor MCP 配置（項目或全局設置中的 .cursor/mcp.json）中：

{
  "mcpServers": {
    "copus": {
      "command": "npx",
      "args": ["copus-mcp-server"]
    }
  }
}

Cline（VS Code 擴展）

在 VS Code 中，將以下內容添加到 Cline 的 MCP 設置中：

1. 打開 VS Code 設置。
2. 搜索 "Cline MCP"。
3. 添加服務器配置：

{
  "copus": {
    "command": "npx",
    "args": ["copus-mcp-server"]
  }
}

Continue（VS Code/JetBrains）

將以下內容添加到您的 Continue 配置（~/.continue/config.json）中：

{
  "mcpServers": [
    {
      "name": "copus",
      "command": "npx",
      "args": ["copus-mcp-server"]
    }
  ]
}

開發

從源代碼構建

git clone https://github.com/copus-io/copus-mcp-server.git
cd copus-mcp-server
npm install
npm run build

在開發環境中運行

npm run dev

測試

# 運行服務器
npm start

# 在另一個終端中，使用 MCP 檢查器或您的 AI 平臺進行測試

API 參考

此 MCP 服務器封裝了 Copus 公共 API：

• 搜索 API：https://copus.network/api/search?q={query}
• 精選內容詳情：https://copus.network/work/{id}?format=json
• OpenAPI 規範：https://copus.network/.well-known/openapi.yaml
• AI 插件清單：https://copus.network/.well-known/ai-plugin.json

鏈接

• Copus 網站：https://copus.network
• 瀏覽主題：https://copus.network/topics
• 所有文章：https://copus.network/articles.txt
• MCP 協議：https://modelcontextprotocol.io
• MCP TypeScript SDK：https://github.com/modelcontextprotocol/typescript-sdk

🔧 技術細節

為何選擇 Copus 而非常規搜索

📄 許可證

本項目採用 MIT 許可證，詳情請參閱 LICENSE。

支持

• 問題反饋：https://github.com/copus-io/copus-mcp-server/issues
• Copus：https://copus.network

由 Copus 團隊精心打造。