百川资源 MCP 服务

项目介绍

百川资源 MCP (Model Context Protocol) 服务是一个基于 MCP 协议的服务端应用，用于获取和处理百川教育资源平台的音频资源。该服务支持两种运行模式：

• STDIO 模式：通过标准输入输出与客户端通信
• SSE 模式：通过 Server-Sent Events 与客户端通信

功能特性

• 支持查询教育资源图书列表
• 支持查询图书章节列表
• 支持获取音频资源详情
• 支持通过 MCP 协议与大模型交互
• 支持多种运行模式（STDIO/SSE）

技术栈

• TypeScript
• Express.js
• MCP SDK (@modelcontextprotocol/sdk)

安装

前置条件

• Node.js >= 16.0.0
• npm

安装步骤

1. 克隆仓库

git clone <仓库地址>
cd bc_resource_mcp

2. 安装依赖

npm install

3. 构建项目

npm run build

使用方法

开发模式

STDIO:

npm build

然后使用客户端或者 MCP Inspector 进行测试

npx @modelcontextprotocol/inspector node dist/index.js

SSE 模式

npm run dev:sse

然后使用支持 SSE 的客户端测试 配置文件

{
  "mcpServers": {
    "bc_resource_mcp": {
    "url": "http://localhost:8083/sse"
      "headers": {
        "MODULE_ID": "1805539756174397441"
      }
    }
  }
}

生产模式

STDIO:

{
  "mcpServers": {
    "bc_resource_mcp": {
      "command": "npx",
      "args": ["bc_resource_mcp"],
      "env": {
        "MODULE_ID": "1805539756174397441"
      }
    }
  }
}

SSE:

{
  "mcpServers": {
    "bc_resource_mcp": {
    "url": "http://localhost:8083/sse"
      "headers": {
        "MODULE_ID": "1805539756174397441"
      }
    }
  }
}