get_notebook_mcp_server 1.0.1 → 1.0.3

package/README.md

@@ -41,6 +41,36 @@ You can test the MCP server interactively using the MCP Inspector:
 npx @modelcontextprotocol/inspector node index.js
 ```
 
+### Running with npx
+
+You can run the server directly without installing it using `npx`:
+
+```bash
+npx get_notebook_mcp_server
+```
+
+### MCP Configuration (Claude Desktop)
+
+Add the following configuration to your `claude_desktop_config.json`:
+
+```json
+{
+  "mcpServers": {
+    "get-notes": {
+      "command": "npx",
+      "args": [
+        "-y",
+        "get_notebook_mcp_server"
+      ],
+      "env": {
+        "GET_API_KEY": "your_api_key_here",
+        "GET_NOTE_TOPIC_ID": "your_topic_id_here"
+      }
+    }
+  }
+}
+```
+
 ### Tools
 
 #### `search_knowledge`
@@ -48,7 +78,7 @@ Search the knowledge base with AI processing.
 
 **Parameters:**
 - `question` (string, required): The question to ask.
-- `topic_ids` (array<string>, required): List of knowledge base IDs.
+- `topic_ids` (array<string>, optional): List of knowledge base IDs. If not provided, uses `GET_NOTE_TOPIC_ID` from environment.
 - `deep_seek` (boolean): Enable deep thinking mode (default: true).
 - `history` (array): Chat history for context.
 
@@ -57,7 +87,7 @@ Raw recall from knowledge base without AI synthesis.
 
 **Parameters:**
 - `question` (string, required): The question or query.
-- `topic_id` (string, required): Knowledge base ID.
+- `topic_id` (string, optional): Knowledge base ID. If not provided, uses `GET_NOTE_TOPIC_ID` from environment.
 - `top_k` (number): Number of results to return (default: 10).
 - `intent_rewrite` (boolean): Enable intent rewrite (default: false).
 

package/index.js

@@ -13,6 +13,8 @@ import logger from './src/logger.js';
 dotenv.config();
 
 const API_KEY = process.env.GET_API_KEY;
+const DEFAULT_TOPIC_ID = process.env.GET_NOTE_TOPIC_ID;
+
 if (!API_KEY) {
     logger.error('GET_API_KEY environment variable is required');
     process.exit(1);
@@ -48,7 +50,7 @@ const SEARCH_KNOWLEDGE_TOOL = {
             topic_ids: {
                 type: 'array',
                 items: { type: 'string' },
-                description: 'List of knowledge base IDs (currently supports only 1)'
+                description: 'List of knowledge base IDs. If not provided, uses the default configured topic ID.'
             },
             deep_seek: {
                 type: 'boolean',
@@ -67,7 +69,7 @@ const SEARCH_KNOWLEDGE_TOOL = {
                 }
             }
         },
-        required: ['question', 'topic_ids']
+        required: ['question']
     }
 };
 
@@ -83,7 +85,7 @@ const RECALL_KNOWLEDGE_TOOL = {
             },
             topic_id: {
                 type: 'string',
-                description: 'Knowledge base ID'
+                description: 'Knowledge base ID. If not provided, uses the default configured topic ID.'
             },
             top_k: {
                 type: 'number',
@@ -96,7 +98,7 @@ const RECALL_KNOWLEDGE_TOOL = {
                 default: false
             }
         },
-        required: ['question', 'topic_id']
+        required: ['question']
     }
 };
 
@@ -112,22 +114,23 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
 
         switch (name) {
             case 'search_knowledge': {
-                const params = args;
+                const params = { ...args };
+
+                // Handle default topic_ids
+                if (!params.topic_ids || params.topic_ids.length === 0) {
+                    if (DEFAULT_TOPIC_ID) {
+                        params.topic_ids = [DEFAULT_TOPIC_ID];
+                    } else {
+                        throw new Error('topic_ids is required (no default configured)');
+                    }
+                }
+
                 // Ensure topic_ids is array
                 if (!Array.isArray(params.topic_ids)) {
                     throw new Error('topic_ids must be an array');
                 }
 
                 const response = await apiClient.searchKnowledge(params);
-                // Handle stream or json response. For MCP tool, we typically wait for full response or handle stream if supported.
-                // The API guide says /stream is optional path, but client uses post /knowledge/search.
-                // If it returns stream, we might need to buffer it or use the non-stream version.
-                // For simplicity in this version, we assume non-stream JSON response unless stream param is explicitly handled.
-                // Actually the API guide shows stream response format. Let's assume we want the final answer.
-                // If the API returns a stream, axios might return a stream object.
-
-                // For now, let's assume standard JSON response if stream is not set to true in params.
-                // If the user wants stream, we might need a different approach, but MCP tools usually return text.
 
                 return {
                     content: [
@@ -140,7 +143,17 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
             }
 
             case 'recall_knowledge': {
-                const params = args;
+                const params = { ...args };
+
+                // Handle default topic_id
+                if (!params.topic_id) {
+                    if (DEFAULT_TOPIC_ID) {
+                        params.topic_id = DEFAULT_TOPIC_ID;
+                    } else {
+                        throw new Error('topic_id is required (no default configured)');
+                    }
+                }
+
                 const response = await apiClient.recallKnowledge(params);
                 return {
                     content: [

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "get_notebook_mcp_server",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "MCP server for Get Notes API integration",
   "type": "module",
   "main": "index.js",