@pandanpc/mcp-server 0.1.0

package/README.md

@@ -0,0 +1,59 @@
+# @pandanpc/mcp-server
+
+PandaNpc MCP Server — 将 PandaNote、工作区、AI 模型和提供商管理能力暴露给 Claude Code、Cursor、Windsurf 等 MCP 客户端。
+
+## 安装
+
+```bash
+npm install -g @pandanpc/mcp-server
+```
+
+安装时自动从 `https://cos.pandanpc.com/mcp-server/` 下载对应平台的 Rust 二进制。
+
+### 支持平台
+
+- Linux x64
+- macOS x64 (Intel)
+- macOS arm64 (Apple Silicon)
+- Windows x64
+
+## Claude Code 配置
+
+编辑 `~/.config/claude-code/config.json`（或对应平台路径）：
+
+```json
+{
+  "mcpServers": {
+    "pandanpc": {
+      "command": "pandanpc-mcp"
+    }
+  }
+}
+```
+
+## 命令行使用
+
+```bash
+# stdio 模式（MCP 客户端默认）
+pandanpc-mcp
+
+# HTTP/SSE 模式
+pandanpc-mcp --http --port 3100
+```
+
+## 可用工具
+
+- `note_login` — 登录 PandaNpc 账号
+- `list_workspaces` / `create_workspace` / `update_workspace` / `delete_workspace`
+- `list_notes` / `create_note` / `read_note` / `update_note` / `delete_note` / `move_note_to_workspace`
+- `search_notes` — 标题 + 全文 + 语义搜索
+- `generate_note_title` — AI 生成标题和图标
+- `list_providers` / `create_provider` / `update_provider` / `delete_provider`
+- `list_models` / `list_model_types` / `create_model` / `update_model` / `delete_model`
+- `sync_rules` — 同步 `.claude/rules/` 和 `.claude/skills/` Markdown 到 PandaNote
+
+首次使用请先调用 `note_login` 登录。
+
+## 许可
+
+MIT © PandaNpc

package/index.js

@@ -0,0 +1,35 @@
+#!/usr/bin/env node
+/**
+ * bin 入口：spawn 对应平台的 pandanpc-mcp 二进制，转发所有参数和 stdio
+ */
+
+const path = require('path')
+const { spawn } = require('child_process')
+const fs = require('fs')
+
+const binName = process.platform === 'win32' ? 'pandanpc-mcp.exe' : 'pandanpc-mcp'
+const binPath = path.join(__dirname, 'bin', binName)
+
+if (!fs.existsSync(binPath)) {
+  console.error(`[pandanpc-mcp] binary not found at ${binPath}`)
+  console.error(`[pandanpc-mcp] try reinstall: npm install -g @pandanpc/mcp-server`)
+  process.exit(1)
+}
+
+const child = spawn(binPath, process.argv.slice(2), {
+  stdio: 'inherit',
+  windowsHide: true,
+})
+
+child.on('exit', (code, signal) => {
+  if (signal) process.kill(process.pid, signal)
+  else process.exit(code ?? 0)
+})
+
+child.on('error', (err) => {
+  console.error(`[pandanpc-mcp] failed to spawn: ${err.message}`)
+  process.exit(1)
+})
+
+process.on('SIGINT', () => child.kill('SIGINT'))
+process.on('SIGTERM', () => child.kill('SIGTERM'))

package/install.js

@@ -0,0 +1,133 @@
+#!/usr/bin/env node
+/**
+ * postinstall: 根据平台下载对应 pandanpc-mcp 二进制到 bin/
+ *
+ * 下载源：https://cos.pandanpc.com/mcp-server/v<version>/pandanpc-mcp-<platform>
+ * 校验：SHA256SUMS
+ */
+
+const fs = require('fs')
+const path = require('path')
+const https = require('https')
+const crypto = require('crypto')
+
+const pkg = require('./package.json')
+const VERSION = pkg.version
+const BASE_URL = `https://cos.pandanpc.com/mcp-server/v${VERSION}`
+
+const PLATFORM_MAP = {
+  'linux-x64': 'pandanpc-mcp-linux-x64',
+  'darwin-x64': 'pandanpc-mcp-darwin-x64',
+  'darwin-arm64': 'pandanpc-mcp-darwin-arm64',
+  'win32-x64': 'pandanpc-mcp-windows-x64.exe',
+}
+
+function detectPlatform() {
+  const key = `${process.platform}-${process.arch}`
+  const name = PLATFORM_MAP[key]
+  if (!name) {
+    throw new Error(`Unsupported platform: ${key}. Supported: ${Object.keys(PLATFORM_MAP).join(', ')}`)
+  }
+  return { key, name }
+}
+
+function download(url, dest) {
+  return new Promise((resolve, reject) => {
+    const file = fs.createWriteStream(dest)
+    const req = https.get(url, (res) => {
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        file.close()
+        fs.unlinkSync(dest)
+        return download(res.headers.location, dest).then(resolve, reject)
+      }
+      if (res.statusCode !== 200) {
+        file.close()
+        fs.unlinkSync(dest)
+        return reject(new Error(`HTTP ${res.statusCode} for ${url}`))
+      }
+      res.pipe(file)
+      file.on('finish', () => file.close(resolve))
+    })
+    req.on('error', (err) => {
+      file.close()
+      try { fs.unlinkSync(dest) } catch {}
+      reject(err)
+    })
+  })
+}
+
+function sha256(file) {
+  return new Promise((resolve, reject) => {
+    const hash = crypto.createHash('sha256')
+    const stream = fs.createReadStream(file)
+    stream.on('data', (d) => hash.update(d))
+    stream.on('end', () => resolve(hash.digest('hex')))
+    stream.on('error', reject)
+  })
+}
+
+async function fetchText(url) {
+  return new Promise((resolve, reject) => {
+    https.get(url, (res) => {
+      if (res.statusCode >= 300 && res.statusCode < 400 && res.headers.location) {
+        return fetchText(res.headers.location).then(resolve, reject)
+      }
+      if (res.statusCode !== 200) return reject(new Error(`HTTP ${res.statusCode}`))
+      let body = ''
+      res.on('data', (c) => (body += c))
+      res.on('end', () => resolve(body))
+    }).on('error', reject)
+  })
+}
+
+async function main() {
+  const { key, name } = detectPlatform()
+  const binDir = path.join(__dirname, 'bin')
+  if (!fs.existsSync(binDir)) fs.mkdirSync(binDir, { recursive: true })
+  const localBin = path.join(binDir, process.platform === 'win32' ? 'pandanpc-mcp.exe' : 'pandanpc-mcp')
+
+  // 如果二进制已存在且有效（开发环境手动拷贝），跳过下载
+  if (fs.existsSync(localBin) && fs.statSync(localBin).size > 0) {
+    console.log(`[pandanpc-mcp] binary already present at ${localBin}, skipping download`)
+    return
+  }
+
+  const url = `${BASE_URL}/${name}`
+  console.log(`[pandanpc-mcp] downloading ${url} → ${localBin}`)
+
+  try {
+    await download(url, localBin)
+  } catch (err) {
+    console.error(`[pandanpc-mcp] download failed: ${err.message}`)
+    console.error(`[pandanpc-mcp] If you are on an unsupported platform, build from source: https://github.com/pandanpc/mcp-server`)
+    process.exit(1)
+  }
+
+  // 校验 SHA256
+  try {
+    const sumsText = await fetchText(`${BASE_URL}/SHA256SUMS`)
+    const line = sumsText.split('\n').find((l) => l.includes(name))
+    if (line) {
+      const expected = line.trim().split(/\s+/)[0]
+      const actual = await sha256(localBin)
+      if (expected !== actual) {
+        fs.unlinkSync(localBin)
+        throw new Error(`SHA256 mismatch: expected ${expected}, got ${actual}`)
+      }
+      console.log(`[pandanpc-mcp] SHA256 verified`)
+    }
+  } catch (err) {
+    console.warn(`[pandanpc-mcp] SHA256 verification skipped: ${err.message}`)
+  }
+
+  if (process.platform !== 'win32') {
+    fs.chmodSync(localBin, 0o755)
+  }
+
+  console.log(`[pandanpc-mcp] installed for ${key}`)
+}
+
+main().catch((err) => {
+  console.error('[pandanpc-mcp] install failed:', err.message)
+  process.exit(1)
+})

package/package.json

@@ -0,0 +1,39 @@
+{
+  "name": "@pandanpc/mcp-server",
+  "version": "0.1.0",
+  "description": "PandaNpc MCP Server — Claude Code and MCP clients integration for PandaNote",
+  "keywords": ["mcp", "pandanpc", "claude", "notes", "panda-note"],
+  "homepage": "https://pandanpc.com",
+  "license": "MIT",
+  "author": "PandaNpc <support@pandanpc.com>",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/pandanpc/mcp-server"
+  },
+  "bin": {
+    "pandanpc-mcp": "index.js"
+  },
+  "files": [
+    "index.js",
+    "install.js",
+    "README.md"
+  ],
+  "scripts": {
+    "postinstall": "node install.js"
+  },
+  "engines": {
+    "node": ">=16"
+  },
+  "os": [
+    "darwin",
+    "linux",
+    "win32"
+  ],
+  "cpu": [
+    "x64",
+    "arm64"
+  ],
+  "publishConfig": {
+    "access": "public"
+  }
+}