Get Notes MCP Server

A Model Context Protocol (MCP) server for integrating with Get Notes API. This server provides tools to search and recall knowledge from your Get Notes knowledge base.

Features

• Knowledge Search: AI-processed search that returns synthesized answers and references.
• Knowledge Recall: Raw recall of relevant notes and files.
• Rate Limiting: Built-in protection with QPS < 2 and Total Requests < 5000 limits.
• Retry Mechanism: Automatic retries for transient network errors (5xx).

Installation

1. Clone the repository
2. Install dependencies:

   npm install

3. Create .env file from example:

   cp .env.example .env

4. Configure your API key in .env:

   GET_API_KEY=your_api_key_here

Usage

Running the Server

node index.js

Testing with MCP Inspector

You can test the MCP server interactively using the MCP Inspector:

npx @modelcontextprotocol/inspector node index.js

Tools

search_knowledge

Search the knowledge base with AI processing.

Parameters:

• question (string, required): The question to ask.
• topic_ids (array, required): List of knowledge base IDs.
• deep_seek (boolean): Enable deep thinking mode (default: true).
• history (array): Chat history for context.

recall_knowledge

Raw recall from knowledge base without AI synthesis.

Parameters:

• question (string, required): The question or query.
• topic_id (string, required): Knowledge base ID.
• top_k (number): Number of results to return (default: 10).
• intent_rewrite (boolean): Enable intent rewrite (default: false).

Development

Running Tests

npm test

Project Structure

• src/api: API client implementation
• src/utils: Utility classes (RateLimiter, etc.)
• tests: Unit and integration tests
• index.js: Main MCP server entry point

License

ISC