@satiyap/confluence-reader-mcp 0.2.0 → 0.2.1

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
 

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.1"
 });
 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);
     }
@@ -96,16 +96,7 @@ 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 { buffer, contentType } = await downloadAttachment(cfg, pageId, match.id);
     const base64 = buffer.toString("base64");
     // Return as base64 image content
     if (contentType.startsWith("image/")) {

package/package.json

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