Get笔记

You can run a local MCP server that connects to Get笔记 (GetBiji) API to provide AI-powered knowledge base search and retrieval. It uses a stdio transport and supports Bearer token authentication, rate limiting, and robust logging, enabling you to integrate Get笔记 data into your MCP client workflows.

How to use

You interact with the Get笔记 MCP Server through an MCP client. Start by choosing one of the available installation methods, then configure the server in your MCP client to point at the local process. The server exposes three MCP tools you can invoke from your MCP client: knowledge_search for AI-enhanced knowledge base search, knowledge_recall for raw content retrieval, and get_rate_limit_stats for current rate limit usage.

How to install

Prerequisites: Ensure you have Node.js and npm installed on your machine.

# Check versions
node -v
npm -v

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 a project dependency

npm install mcp-get-biji-server

Configuration

Prepare environment variables and base settings. Create a local environment file and provide your API credentials and options.

# Example environment file values
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 with Claude Desktop

Configure Claude Desktop to run the MCP server locally. You can choose among three runtime configurations depending on how you installed the server. Each configuration defines the command to start the MCP server and the necessary environment variables.

{
  "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"
      }
    }
  }
}

If you prefer to run via npx, use this configuration.

{
  "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"
      }
    }
  }
}

If you install locally, point to the built entry script.

{
  "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"
      }
    }
  }
}

MCP Tools

The server provides three MCP tools: knowledge_search, knowledge_recall, and get_rate_limit_stats. Use each tool through your MCP client to perform AI-enhanced search, raw content recall, and rate limit statistics respectively.

Development

Development commands to build, test, and run the server.

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

The server enforces API rate limits with intelligent queuing. You can configure QPS and daily limits to match Get笔记 usage.

Project notes

Key technologies include Node.js with ES Modules, TypeScript, and Axios. The server uses a dedicated API client to interact with Get笔记 and provides a typed, safe interface for MCP integrations.

Available tools

knowledge_search

AI-enhanced search with deep processing to return comprehensive answers from your knowledge base.

knowledge_recall

Fast retrieval of raw content without AI processing for quick previews.

get_rate_limit_stats

Provide current API rate limit usage statistics.