bilibili -js

This MCP server implements a Bilibili video search service. It exposes API capabilities to search Bilibili videos based on keywords, retrieve popular content (overall hot lists, must-watch lists, rankings, and site-wide music charts), fetch detailed video information using BV or AV identifiers, obtain Uploader/UP 主 information (basic stats like fans and followings), and provide programmatic access to a drama/anime timetable within a given date range. The project includes LangChain example integrations and test scripts to help you validate behavior within an AI-assisted workflow. You can start the service using npx bilibili-mcp-js (as shown in the npm usage example) or run the built distribution directly if you build the project locally. Once running, you can query the MCP endpoints from your AI app to retrieve structured video data, metadata, and timetables for Bilibili content.

Prerequisites: - Node.js >= 20.12.0 - npm or bun (for package management)

Install options:

1. Quick start (via npx):

• Ensure Node.js is installed
• Use the MCP configuration from the README by including: { "mcpServers": { "bilibili-search": { "command": "npx", "args": ["bilibili-mcp-js"] } } } This will pull and run the bilibili-mcp-js MCP server on demand.

2. Local development (build required):

• Clone or download the repository containing bilibili-mcp-js
• Install dependencies: npm install
• Build the project (if a build step exists): npm run build
• Run using the built dist file (example path shown in README): node dist/index.js

3. Alternative run (via bun or npm scripts):

• Bun: bun i | bun index.ts | TRANSPORT=remote bun index.ts
• NPM: npm i | npm run start | TRANSPORT=remote npm run start Replace the path to the built entry point if you’re using a dist workflow.

Prerequisites recap:

• Compatible Node.js environment
• Access to npm or bun to install dependencies
• If you plan to build locally, ensure the project exposes a dist/index.js or equivalent entry point.

Tips and notes:

• If you encounter network or package resolution issues when using npx bilibili-mcp-js, ensure your npm cache is healthy and you have network access to the npm registry.
• The service relies on Bilibili data; ensure you respect API rate limits and terms of service when querying large volumes of content.
• If you customize the server, you can extend functionality to add new endpoints for additional Bilibili features or to adjust search filters and result formats.
• When running locally, you may need to adjust environment variables or configuration to point to local API keys or proxy settings if required by your hosting environment.
• If you switch from npx to a local build, make sure your entry path (e.g., dist/index.js) matches the actual built artifact in your environment.