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 团队精心打造。