@satiyap/confluence-reader-mcp 0.2.0 → 0.2.2

package/README.md

@@ -36,8 +36,10 @@ Reload your shell or open a new terminal.
 |----------|----------|-------------|
 | `CONFLUENCE_TOKEN` | Yes | Scoped API token |
 | `CONFLUENCE_EMAIL` | Yes | Email tied to your Atlassian account |
-| `CONFLUENCE_CLOUD_ID` | One of these | Cloud ID — routes via `api.atlassian.com` |
-| `CONFLUENCE_BASE_URL` | is required | Direct tenant URL, e.g. `https://your-org.atlassian.net` |
+| `CONFLUENCE_CLOUD_ID` | Yes* | Cloud ID — routes via `api.atlassian.com` |
+| `CONFLUENCE_BASE_URL` | Yes* | Direct tenant URL, e.g. `https://your-org.atlassian.net` |
+
+*One of `CONFLUENCE_CLOUD_ID` or `CONFLUENCE_BASE_URL` is required. `CONFLUENCE_CLOUD_ID` is recommended.
 
 ### 3. Add to MCP Config
 
@@ -74,12 +76,13 @@ Lists the direct child pages of a Confluence page without fetching their content
 
 ### `confluence.fetch_image`
 
-Downloads an image attachment from a Confluence page by filename. Returns the image as base64-encoded data.
+Downloads an image attachment from a Confluence page by filename and saves it to a local directory.
 
 | Parameter | Type | Description |
 |-----------|------|-------------|
 | `url` | string | Confluence page URL |
 | `filename` | string | Attachment filename (e.g. `architecture.png`) |
+| `destination` | string | Local directory path to save the image to |
 
 ### `confluence.compare`
 

package/dist/confluence/client.js

@@ -123,12 +123,12 @@ export async function fetchAttachments(cfg, pageId) {
     return all;
 }
 /**
- * Download an attachment binary by its download link.
- * Returns the raw Buffer and content type.
+ * Download an attachment binary from a Confluence page.
+ * Uses the v1 REST API download endpoint which works with scoped tokens.
  */
-export async function downloadAttachment(cfg, downloadLink) {
+export async function downloadAttachment(cfg, pageId, attachmentId) {
     const base = buildBase(cfg);
-    const url = `${base}/wiki${downloadLink}`;
+    const url = `${base}/wiki/rest/api/content/${pageId}/child/attachment/${attachmentId}/download`;
     const res = await fetch(url, {
         method: "GET",
         headers: buildAuthHeaders(cfg),

package/dist/index.js

@@ -8,7 +8,7 @@ import { storageToMarkdown } from "./confluence/transform.js";
 import { generateUnifiedDiff, generateDiffStats } from "./compare/diff.js";
 const server = new McpServer({
     name: "confluence-reader-mcp",
-    version: "0.2.0"
+    version: "0.2.2"
 });
 function getEnv(name) {
     const v = process.env[name];
@@ -34,7 +34,7 @@ function validateEnvironment() {
         errors.forEach(err => console.error(`  • ${err}`));
         console.error("\nSet the required environment variables in your shell profile (~/.zshrc, ~/.bashrc, etc.):\n");
         console.error("  export CONFLUENCE_TOKEN=\"your_scoped_token\"");
-        console.error("  export CONFLUENCE_EMAIL=\"you@company.com\"");
+        console.error("  export CONFLUENCE_EMAIL=\"your_email@example.com\"");
         console.error("  export CONFLUENCE_CLOUD_ID=\"xxxxxxxx-xxxx-xxxx-xxxx-xxxxxxxxxxxx\"\n");
         process.exit(1);
     }
@@ -79,10 +79,11 @@ server.tool("confluence.list_children", "List the direct child pages of a Conflu
         : "No child pages found.";
     return { content: [{ type: "text", text }] };
 });
-server.tool("confluence.fetch_image", "Download an image attachment from a Confluence page by filename. Returns the image as base64-encoded data.", {
+server.tool("confluence.fetch_image", "Download an image attachment from a Confluence page by filename and save it to a local directory. Returns the saved file path.", {
     url: z.string().describe("Confluence page URL"),
-    filename: z.string().describe("Attachment filename (e.g. 'architecture.png')")
-}, async ({ url, filename }) => {
+    filename: z.string().describe("Attachment filename (e.g. 'architecture.png')"),
+    destination: z.string().describe("Local directory path to save the image to")
+}, async ({ url, filename, destination }) => {
     const cfg = getCfg();
     const pageId = extractConfluencePageId(url);
     const attachments = await fetchAttachments(cfg, pageId);
@@ -96,32 +97,17 @@ server.tool("confluence.fetch_image", "Download an image attachment from a Confl
                 }]
         };
     }
-    const downloadLink = match.downloadLink ?? match._links?.download;
-    if (!downloadLink) {
-        return {
-            content: [{
-                    type: "text",
-                    text: `No download link available for "${filename}".`
-                }]
-        };
-    }
-    const { buffer, contentType } = await downloadAttachment(cfg, downloadLink);
-    const base64 = buffer.toString("base64");
-    // Return as base64 image content
-    if (contentType.startsWith("image/")) {
-        return {
-            content: [{
-                    type: "image",
-                    data: base64,
-                    mimeType: contentType,
-                }]
-        };
-    }
-    // Non-image attachment — return as base64 text
+    const { buffer } = await downloadAttachment(cfg, pageId, match.id);
+    // Ensure destination directory exists
+    const fs = await import("node:fs/promises");
+    const path = await import("node:path");
+    await fs.mkdir(destination, { recursive: true });
+    const filePath = path.join(destination, match.title);
+    await fs.writeFile(filePath, buffer);
     return {
         content: [{
                 type: "text",
-                text: `Downloaded "${filename}" (${contentType}, ${buffer.length} bytes).\nBase64: ${base64.slice(0, 200)}...`
+                text: `Saved "${match.title}" (${buffer.length} bytes) to ${filePath}`
             }]
     };
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@satiyap/confluence-reader-mcp",
-  "version": "0.2.0",
+  "version": "0.2.2",
   "description": "MCP server for fetching and comparing Confluence documentation with local files",
   "author": "satiyap",
   "license": "MIT",