secondbrainos-mcp-server 1.9.0 → 1.10.0

package/README.md

@@ -171,7 +171,7 @@ Credentials are stored securely at `~/.secondbrainos/credentials.json` (created
 7. **Slash commands** (0 credits): When a user runs a slash command (e.g. `/secondbrainos:agent_my_agent`), the server returns the full agent/skill definition from cache — no API calls
 8. **`start_secondbrainos`** (0 credits): Builds a context document from cached agents and workflows — an index of all available slash commands with descriptions, enabling Claude to discover and invoke agents/skills autonomously
 9. **Tool calls** (billed per call): When Claude calls an MCP tool (e.g. `runPromptChain` with a specific entity/entity_id to fetch prompt instructions, or `searchMyKnowledge`), the server executes the API call via `api.secondbrainos.com` with authentication
-10. **File upload**: If a tool argument contains a local file path (e.g. `addToMyKnowledge` with `file_path`), the server validates the extension, uploads the file to GCS via `generateFileUploadGoogleCloudStorageURL`, and replaces the path with the GCS URI before forwarding the API call
+10. **File upload**: If a tool argument contains a local file path (e.g. `addToMyKnowledge` with `file_path`), the server validates the extension (`.txt`, `.md`, `.png`, `.jpg`, `.jpeg`, `.gif`, `.webp`, `.pdf`), uploads the file to GCS via `generateFileUploadGoogleCloudStorageURL` with the correct MIME type, and replaces the path with the GCS URI before forwarding the API call
 
 ### Credit Cost
 

package/build/index.js

@@ -540,17 +540,19 @@ class SecondBrainOSServer {
             if (!fs.existsSync(trimmed)) {
                 throw new McpError(ErrorCode.InvalidRequest, `Local file not found: ${trimmed}`);
             }
-            const fileContent = fs.readFileSync(trimmed, 'utf-8');
-            if (!fileContent.trim()) {
+            const isText = SecondBrainOSServer.TEXT_EXTENSIONS.has(ext);
+            const mimeType = SecondBrainOSServer.MIME_TYPES[ext] || 'application/octet-stream';
+            const fileBuffer = fs.readFileSync(trimmed);
+            if (fileBuffer.length === 0 || (isText && !fileBuffer.toString('utf-8').trim())) {
                 throw new McpError(ErrorCode.InvalidRequest, `File is empty: ${trimmed}`);
             }
             const fileName = path.basename(trimmed);
-            const fileSize = Buffer.byteLength(fileContent, 'utf-8');
+            const fileSize = fileBuffer.length;
             // Step 1: Get signed upload URL from the GCF
             const uploadUrlResponse = await axios.post(`${this.baseUrl}${this.generateUploadURLPath}`, {
                 file_name: fileName,
                 file_size: fileSize,
-                mime_type: 'text/plain'
+                mime_type: mimeType
             }, {
                 headers: {
                     'Authorization': `Bearer ${this.userId}:${this.userSecret}`,
@@ -559,10 +561,12 @@ class SecondBrainOSServer {
             });
             const { upload_url, gs_path } = uploadUrlResponse.data;
             // Step 2: PUT file content directly to GCS via signed URL
-            await axios.put(upload_url, fileContent, {
+            await axios.put(upload_url, fileBuffer, {
                 headers: {
-                    'Content-Type': 'text/plain'
-                }
+                    'Content-Type': mimeType
+                },
+                maxContentLength: Infinity,
+                maxBodyLength: Infinity
             });
             console.error(`Uploaded local file to ${gs_path}`);
             result[key] = gs_path;
@@ -671,6 +675,30 @@ An agent definition combines:
 - NEVER write these to local disk/drive — even if the user asks. They must always be fetched live from Second Brain OS to avoid stale data
 - Always retrieve the latest version from the server rather than caching or saving locally
 
+## Notes on Key Tools
+
+### File Uploads (\`generateFileUploadGoogleCloudStorageURL\`)
+- **Almost never call this directly.** The MCP server uses it transparently: when any tool argument named \`file_path\` (or containing \`file_path\`) is a local file path, the server automatically uploads the file to GCS via this service and replaces the path with a \`gs://\` URI before forwarding the call.
+- Only \`.txt\` and \`.md\` files are supported. \`https://\` URLs are passed through unchanged; \`http://\` is rejected.
+
+### Discovery Tools (\`runPromptChain\`, \`getAIAgentsSchema\`)
+- Use these to **fetch a specific** workflow, prompt, or agent — always pass \`entity\` + \`entity_id\` (or \`tab_id\`). Never call without these parameters.
+- They can also be used to **list all** workflows / agents, but you shouldn't need to: the start command above already lists everything the server cached at connect time.
+- **If the list returned by these tools differs from what's in this start command**, your MCP connection is stale — ask the user to reconnect/refresh the SBOS MCP server.
+
+### Marketplace Search & Service Requests (\`searchWorkflowMarketPlace\`, \`searchServicesMarketPlace\`, \`searchTabsMarketPlace\`, \`requestNewService\`)
+- Users are non-technical. Before suggesting any external step — installing plugins, fetching code from the internet, writing Python/Bash/JavaScript, or exposing webhooks — **first search the marketplaces** for an existing tool, skill, or agent.
+- If nothing matches, use \`requestNewService\` to formally request a new capability instead of working around the gap.
+- \`requestNewService\` **always requires a \`file_path\`** — write the context to a local \`.md\` or \`.txt\` file before calling it.
+
+### Sub-Agent Testing (\`messageSubAgent\`)
+- Engages the user's **public-facing AI agent** configured at \`secondbrainos.com/dashboard > Agent Settings\`.
+- Primarily used to fine-tune and test the agent: verify behaviour, validate knowledge retrieval, confirm tool availability, and debug tool execution end-to-end.
+
+### User State Tools (\`getUserServices\`, \`getUserCredits\`)
+- \`getUserServices\` — returns services the user currently has access to. If this differs from the MCP tools available in this session, ask the user to reconnect the SBOS MCP server.
+- \`getUserCredits\` — returns the user's available SBOS credits.
+
 ## Available Agents
 ${agentIndex || '_None configured_'}
 
@@ -695,7 +723,18 @@ ${this.cachedFeatures.length > 0
         console.error("Second Brain OS MCP server running on stdio");
     }
 }
-SecondBrainOSServer.ALLOWED_EXTENSIONS = ['.txt', '.md'];
+SecondBrainOSServer.ALLOWED_EXTENSIONS = ['.txt', '.md', '.png', '.jpg', '.jpeg', '.gif', '.webp', '.pdf'];
+SecondBrainOSServer.MIME_TYPES = {
+    '.txt': 'text/plain',
+    '.md': 'text/markdown',
+    '.png': 'image/png',
+    '.jpg': 'image/jpeg',
+    '.jpeg': 'image/jpeg',
+    '.gif': 'image/gif',
+    '.webp': 'image/webp',
+    '.pdf': 'application/pdf',
+};
+SecondBrainOSServer.TEXT_EXTENSIONS = new Set(['.txt', '.md']);
 // Function to fetch the schema from the API
 async function fetchSchema() {
     const userId = process.env.USER_ID;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "secondbrainos-mcp-server",
-  "version": "1.9.0",
+  "version": "1.10.0",
   "description": "Second Brain OS MCP Server for Claude Desktop",
   "type": "module",
   "main": "build/index.js",