Copus

Provides access to Copus's human-curated content database via MCP to fetch and explore recommended resources.

javascript

0

GitHub Stars

javascript

Language

4 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "copus-io-copus-mcp-server": {
      "command": "npx",
      "args": [
        "copus-mcp-server"
      ],
      "env": {
        "YOUR_ENV_VAR": "VALUE"
      }
    }
  }
}

Copus MCP Server lets your AI assistants search and retrieve human-curated content recommendations from Copus, enabling high-quality, expert-backed results to surface when users seek resources, tools, and readings. It provides an MCP interface so your AI can request curated content and receive rich metadata, including why a curator recommends an item and who the curator is.

How to use

You connect to Copus via an MCP client that supports the Model Context Protocol. Configure your client to point to the Copus MCP server using the provided command, then ask your AI to search for curations or fetch detailed curation data. Typical workflows include querying for learning resources, tools, or articles and then presenting curated results with curator notes and engagement metrics.

How to install

Prerequisites: you need Node.js and npm installed on your machine or development environment.

Quick Start (npx) Run the MCP server directly without installing globally.

npx copus-mcp-server

Global Installation Install the MCP server globally so you can run the command from anywhere.

npm install -g copus-mcp-server

Then start the server from your shell.

copus-mcp-server

Local Installation Install the MCP server in your project so it is available to your app.

npm install copus-mcp-server

Configuration

You configure Copus MCP Server with your MCP client. The following examples show how to wire Copus into several MCP-enabled clients. Each configuration uses the same runtime command, invoking the MCP server via npx.

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

Additional configuration notes

If you install Copus MCP Server globally, you can simplify configurations to use the direct command without npx.

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

Available tools

search_curations

Search human-curated content recommendations on Copus with a query and optional limit to control results.

get_curation

Retrieve detailed information about a specific curation by its ID, including notes, credentials, and engagement metrics.