Get Biji MCP

🚀 Get Notes MCP Server

This Model Context Protocol (MCP) server integrates with the Get Notes (GetBiji) API, offering AI-powered knowledge base search and retrieval capabilities.

🚀 Quick Start

The Get Notes MCP Server is designed to integrate with the Get Notes API, enabling AI - enhanced knowledge base search and retrieval. Follow the steps below to get started.

✨ Features

• ✅ MCP server framework with stdio transport
• ✅ Get Notes API client with Bearer token authentication
• ✅ Rate limiting (2 QPS, 5000 requests/day)
• ✅ Comprehensive error handling and logging
• ✅ TypeScript with full type safety
• ✅ Three MCP tools:
  • knowledge_search: AI - enhanced knowledge base search
  • knowledge_recall: Raw content retrieval
  • get_rate_limit_stats: Rate limit statistics

📦 Installation

You have three options to install the mcp - get - biji - server:

Option 1: Install globally (recommended for frequent use)

npm install -g mcp-get-biji-server

Option 2: Use with npx (no installation required)

npx mcp-get-biji-server

Option 3: Install as project dependency

npm install mcp-get-biji-server

📚 Configuration

1. Copy the environment template:

cp .env.example .env

2. Edit .env and add your API key:

GET_BIJI_API_KEY=your_api_key_here
GET_BIJI_API_BASE_URL=https://open-api.biji.com/getnote/openapi
LOG_LEVEL=info
REQUEST_TIMEOUT=30000
RATE_LIMIT_QPS=2
RATE_LIMIT_DAILY=5000

💻 Usage Examples

Usage with Claude Desktop

Edit your Claude Desktop config file (~/Library/Application Support/Claude/claude_desktop_config.json).

Using global installation:

{
  "mcpServers": {
    "get-biji": {
      "command": "mcp-get-biji-server",
      "env": {
        "GET_BIJI_API_KEY": "your_api_key_here",
        "GET_BIJI_DEFAULT_TOPIC_ID": "your_default_topic_id"
      }
    }
  }
}

Using npx:

{
  "mcpServers": {
    "get-biji": {
      "command": "npx",
      "args": ["-y", "mcp-get-biji-server"],
      "env": {
        "GET_BIJI_API_KEY": "your_api_key_here",
        "GET_BIJI_DEFAULT_TOPIC_ID": "your_default_topic_id"
      }
    }
  }
}

Using local installation:

{
  "mcpServers": {
    "get-biji": {
      "command": "node",
      "args": ["/path/to/node_modules/mcp-get-biji-server/build/index.js"],
      "env": {
        "GET_BIJI_API_KEY": "your_api_key_here",
        "GET_BIJI_DEFAULT_TOPIC_ID": "your_default_topic_id"
      }
    }
  }
}

Restart Claude Desktop to activate the server.

MCP Tools

1. knowledge_search

AI - enhanced search with deep processing.

Parameters:

• question (required): Search query
• topic_ids (required): Knowledge base ID list (currently supports 1)
• deep_seek (required): Enable deep thinking
• refs (optional): Include references
• history (optional): Conversation history for follow - up

2. knowledge_recall

Fast retrieval of raw content without AI processing.

Parameters:

• question (required): Search query
• topic_id (optional): Single knowledge base ID (preferred)
• topic_ids (optional): Knowledge base ID list
• top_k (optional): Number of top results (default: 10)
• intent_rewrite (optional): Enable intent rewriting
• select_matrix (optional): Enable result re - selection
• history (optional): Conversation history

Note: Either topic_id or topic_ids must be provided. topic_id takes priority.

3. get_rate_limit_stats

Get current API rate limit usage statistics.

🔧 Technical Details

Development

npm run build        # Compile TypeScript
npm run watch        # Watch mode compilation
npm run dev          # Build and run
npm test             # Run tests
npm start            # Run (must build first)

API Rate Limits

• QPS: 2 requests/second
• Daily: 5000 requests/day

The server automatically handles rate limiting with intelligent queuing.

Project Structure

.
├── src/                  # Source code
│   ├── index.ts         # MCP server entry
│   ├── client.ts        # API client
│   ├── config.ts        # Configuration
│   ├── logger.ts        # Logging system
│   ├── rate-limiter.ts  # Rate limiter
│   ├── types.ts         # Type definitions
│   └── test.ts          # Test script
├── build/               # Compiled output
├── .env                 # Environment variables
└── package.json         # Project config

Tech Stack

• Node.js (ES Modules)
• TypeScript
• @modelcontextprotocol/sdk
• Axios
• dotenv

📄 License

This project is licensed under the MIT license.

Contributing

Contributions are welcome! Please open an issue or submit a pull request.

Special thanks to the contribution & development of Xiaoyibao - Pancrepal & [xiao - x - bao community](https://info.xiao - x - bao.com.cn) to support cancer/rare disease patients and their families with ❤️ & AI!