@falconer/mcp 0.1.0

package/README.md

@@ -0,0 +1,44 @@
+# @falconer/mcp
+
+MCP server for [Falconer](https://falconer.com).
+
+## Setup
+
+### 1. Install CLI and authenticate
+
+```bash
+npm install -g @falconer/cli
+falconer login
+```
+
+### 2. Add MCP server
+
+**Claude Code**:
+```bash
+claude mcp add falconer -- npx @falconer/mcp
+```
+
+**Cursor** — add to `~/.cursor/mcp.json`:
+```json
+{
+  "mcpServers": {
+    "falconer": {
+      "command": "npx",
+      "args": ["@falconer/mcp"]
+    }
+  }
+}
+```
+
+### 3. Verify
+
+- **Claude Code**: Restart and run `/mcp`
+- **Cursor**: Open Command Palette → "View: Open MCP Settings"
+
+## Tools
+
+| Tool | Input | Description |
+|------|-------|-------------|
+| `read` | `identifier` | Fetch a document by ID, slug, title, or URL |
+| `search` | `query` | Search for documents |
+| `create` | `content` | Create a new document from markdown |

package/bin/falconer-mcp

@@ -0,0 +1,61 @@
+#!/usr/bin/env node
+
+const { execFileSync } = require('child_process')
+const os = require('os')
+
+const PLATFORMS = {
+  'darwin arm64': {
+    package: '@falconer/mcp-darwin-arm64',
+    binary: 'falconer-mcp',
+  },
+  'darwin x64': {
+    package: '@falconer/mcp-darwin-x64',
+    binary: 'falconer-mcp',
+  },
+  'linux x64': {
+    package: '@falconer/mcp-linux-x64',
+    binary: 'falconer-mcp',
+  },
+  'linux arm64': {
+    package: '@falconer/mcp-linux-arm64',
+    binary: 'falconer-mcp',
+  },
+  'win32 x64': {
+    package: '@falconer/mcp-windows-x64',
+    binary: 'falconer-mcp.exe',
+  },
+}
+
+function getBinaryPath() {
+  const platformKey = `${process.platform} ${os.arch()}`
+  const platform = PLATFORMS[platformKey]
+
+  if (!platform) {
+    throw new Error(
+      `Unsupported platform: ${platformKey}\n` +
+        `Falconer MCP supports: ${Object.keys(PLATFORMS).join(', ')}`
+    )
+  }
+
+  try {
+    return require.resolve(`${platform.package}/${platform.binary}`)
+  } catch (e) {
+    throw new Error(
+      `The package "${platform.package}" could not be found.\n\n` +
+        `If you installed with npm, make sure you didn't use "--no-optional" or "--omit=optional".\n` +
+        `The "optionalDependencies" feature is used to install the correct binary for your platform.`
+    )
+  }
+}
+
+const binaryPath = getBinaryPath()
+const args = process.argv.slice(2)
+
+try {
+  execFileSync(binaryPath, args, { stdio: 'inherit' })
+} catch (e) {
+  if (e.status !== undefined) {
+    process.exit(e.status)
+  }
+  throw e
+}

package/package.json

@@ -0,0 +1,20 @@
+{
+  "name": "@falconer/mcp",
+  "version": "0.1.0",
+  "description": "Falconer MCP Server - access your Falconer documents from Claude",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/FalconerAI/falconer.git"
+  },
+  "license": "MIT",
+  "bin": {
+    "falconer-mcp": "bin/falconer-mcp"
+  },
+  "optionalDependencies": {
+    "@falconer/mcp-darwin-arm64": "0.1.0",
+    "@falconer/mcp-darwin-x64": "0.1.0",
+    "@falconer/mcp-linux-x64": "0.1.0",
+    "@falconer/mcp-linux-arm64": "0.1.0",
+    "@falconer/mcp-windows-x64": "0.1.0"
+  }
+}