Copus MCP Server

🚀 Copus MCP Server

このサーバーはAIアシスタントがCopusから人為的に選りすぐられたコンテンツの推薦を検索して取得できる、MCP（Model Context Protocol）サーバーです。

🚀 クイックスタート

Copus MCP Serverを使用すれば、AIアシスタントがCopusの選りすぐられたコンテンツデータベースにアクセスできます。一般的な検索結果ではなく、専門家によって精査されたツールやリソース、現場の実践者によって推薦された記事、実際の人々が共有する価値があると感じた隠れた宝石のようなコンテンツを見つけることができます。

✨ 主な機能

Copusとは？

Copusは人為的に選りすぐられたコンテンツ発見プラットフォームで、「インターネットの宝の地図」とも呼ばれています。SEOによる検索結果とは異なり、Copusはコンテンツがなぜ価値があるのかを説明する実際の人々からの推薦を浮き彫りにします。

各選りすぐりには以下が含まれます：

• 選りすぐり者の個人的なメモ — なぜこれを推薦するのか
• 選りすぐり者の資格情報 — なぜ彼らがこれを推薦する資格があるのか
• 元のソースURL — 推薦されている実際のコンテンツ
• AIによって強化されたメタデータ — 主な要点、対象読者、解決される問題
• エンゲージメント指標 — コミュニティからの閲覧数、保存数、コメント数

このMCPサーバーが可能にすること

このサーバーはAIアシスタントにCopusの選りすぐられたコンテンツデータベースへのアクセスを提供します。一般的な検索結果ではなく、あなたのAIは以下を見つけることができます：

• 専門家によって精査されたツールやリソース
• 分野の実践者によって推薦された記事
• 実際の人々が共有する価値があると感じた隠れた宝石のようなコンテンツ

互換性のあるAIプラットフォーム

このMCPサーバーは、Model Context Protocolをサポートする任意の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

📚 ドキュメント

設定

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"]
    }
  ]
}

利用可能なツール

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
      }
    }
  ]
}

通常の検索よりもCopusを使う理由

開発

ソースからビルド

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

コントリビュート

コントリビューションは大歓迎です！プルリクエストを送信してください。

1. リポジトリをフォークします。
2. あなたの機能ブランチを作成します (git checkout -b feature/amazing-feature)
3. 変更をコミットします (git commit -m 'Add amazing feature')
4. ブランチにプッシュします (git push origin feature/amazing-feature)
5. プルリクエストを開きます。

📄 ライセンス

MITライセンス - 詳細はLICENSEを参照してください。

サポート

• 問題報告: https://github.com/copus-io/copus-mcp-server/issues
• Copus: https://copus.network

Copusチームによって愛情を込めて作成されました。