awesome-copilot-mcp

@RbBtSn0w/awesome-copilot-mcp

0 Stars 3 次浏览 RbBtSn0w 更新于 2026-08-23

Model Context Protocol server for awesome-copilot agents and collections

MCP 服务配置

复制以下 JSON 到 OPClaw 或其他 MCP 客户端的配置文件中即可使用

{
  "mcpServers": {
    "awesome-copilot-mcp": {
      "args": [
        "awesome-copilot-mcp@0.3.0"
      ],
      "command": "npx"
    }
  }
}

可用工具（5 个）

该服务在 MCP 协议中暴露的工具，AI 可按需调用

tavily_search 14 个参数需填 1 项 Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

Search the web for current information on any topic. Use for news, facts, or data beyond your knowledge cutoff. Returns snippets and source URLs.

必填参数：query

tavily_extract 6 个参数需填 1 项 Extract content from URLs. Returns raw page content in markdown or text format.

Extract content from URLs. Returns raw page content in markdown or text format.

必填参数：urls

tavily_crawl 11 个参数需填 1 项 Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.

Crawl a website starting from a URL. Extracts content from pages with configurable depth and breadth.

必填参数：url

tavily_map 8 个参数需填 1 项 Map a website's structure. Returns a list of URLs found starting from the base URL.

Map a website's structure. Returns a list of URLs found starting from the base URL.

必填参数：url

tavily_research 2 个参数需填 1 项 Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.

Perform comprehensive research on a given topic or question. Use this tool when you need to gather information from multiple sources to answer a question or complete a task. Returns a detailed response based on the research findings.

必填参数：input

服务介绍

Awesome Copilot MCP Server

A Model Context Protocol (MCP) server that provides access to awesome-copilot agents and collection resources.

Quick Start

One-Click Installation for VS Code

Click the badge to install directly in VS Code (will prompt to open VS Code):

Note: Requires GitHub Copilot extension in VS Code. Click the badge on GitHub to trigger the installation prompt.

Manual Configuration

Add to your MCP Client configuration (e.g., Claude Desktop or VS Code):

{
  "mcpServers": {
    "awesome-copilot": {
      "command": "npx",
      "args": ["-y", "awesome-copilot-mcp", "start"]
    }
  }
}

This ensures you always run the latest version.

Usage

As MCP Server

Standard stdio usage (default). See configuration above.

As HTTP / OpenAPI Server

Run locally for remote access or OpenAPI testing:

npx -y awesome-copilot-mcp start-http --port 8080 --host 0.0.0.0

Available endpoints:

GET /health Health check
GET /metadata Return metadata index
GET /metadata/stream SSE streaming output of metadata
GET /search?q=kw Search
GET /openapi.json API Documentation

Debugging

MCP Inspector is the recommended way to test and debug:

# Debug via Stdio (Recommended)
npx -y awesome-copilot-mcp debug --no-build

# Debug via HTTP
npm run inspect:http

Architecture

This server uses a Bundled + In-Memory architecture for maximum reliability:

Startup: Loads metadata.json bundled directly within the npm package. Zero external dependencies.
Hot Updates: refresh_metadata fetches the latest data from GitHub and stores it in memory for the current session.
Sandbox Friendly: No local disk cache (~/.cache) is used, preventing permission issues in restricted environments (e.g., macOS App Sandbox).

Environment Variables

Variable	Description
`ACP_METADATA_URL`	Optional. URL to a hosted `metadata.json` (e.g. `https://yourname.github.io/repo/metadata.json`). Overrides GitHub raw fetch.
`ACP_REPOS_JSON`	Custom repository configuration JSON.

Metadata Generation

Automated: GitHub Actions runs daily to fetch the latest metadata from github/awesome-copilot and publishes a new npm version if changes are detected.

Internal:
The metadata file is lightweight (~170 KB) containing only index info. Actual content (Agent instructions, prompts) is fetched on-demand via the download tool.

Development

# Install dependencies
npm install

# Build
npm run build

# Run tests
npm test

License

MIT

查看源码项目主页