fly-agent-mcp 1.0.0

package/README.md

@@ -0,0 +1,86 @@
+# Fly Agent MCP Proxy
+
+Connect Claude Desktop to Fly Agent's Google Business Profile management tools via MCP (Model Context Protocol).
+
+## Installation
+
+```bash
+npm install -g @anthropic-fly/mcp-proxy
+```
+
+## Setup
+
+### 1. Get your API Key
+
+1. Log in to [fly-social.com](https://app.fly-social.com)
+2. Go to Settings → Integrations → API Keys
+3. Generate a new API key (starts with `fly_sk_...`)
+
+### 2. Configure Claude Desktop
+
+Edit your Claude Desktop config file:
+
+**macOS:** `~/Library/Application Support/Claude/claude_desktop_config.json`
+**Windows:** `%APPDATA%\Claude\claude_desktop_config.json`
+
+```json
+{
+  "mcpServers": {
+    "fly-agent": {
+      "command": "fly-mcp",
+      "env": {
+        "FLY_API_KEY": "fly_sk_your_api_key_here",
+        "FLY_ENV": "main"
+      }
+    }
+  }
+}
+```
+
+### 3. Restart Claude Desktop
+
+The Fly Agent tools will now be available in Claude Desktop.
+
+## Environment Variables
+
+| Variable | Required | Description |
+|----------|----------|-------------|
+| `FLY_API_KEY` | Yes | Your Fly Agent API key |
+| `FLY_ENV` | No | Environment: `dev`, `staging`, or `main` (default: `dev`) |
+| `FLY_MCP_URL` | No | Custom MCP server URL (overrides FLY_ENV) |
+
+## Available Tools
+
+Once connected, you can ask Claude to:
+
+- **Reviews**: Get recent reviews, respond to reviews, view review stats
+- **Profile**: View and update your Google Business Profile
+- **Content**: Generate and publish posts to your GBP
+- **Rankings**: Track local keyword rankings
+- **Performance**: View performance metrics and insights
+- **Reports**: Generate monthly performance reports
+- And 130+ more tools...
+
+## Example Prompts
+
+- "Show me my recent reviews"
+- "What's my average rating?"
+- "Generate a post about our weekend special"
+- "Show my performance stats for the last 30 days"
+- "What keywords am I ranking for?"
+
+## Troubleshooting
+
+### Claude Desktop hangs on startup
+
+Try using the local Python transport instead (see main documentation).
+
+### "Invalid API key" error
+
+1. Verify your API key is correct
+2. Check it hasn't expired
+3. Ensure you have at least one location connected
+
+## License
+
+MIT

package/index.js

@@ -0,0 +1,119 @@
+#!/usr/bin/env node
+/**
+ * MCP Proxy for Fly Agent
+ *
+ * Bridges Claude Desktop (stdio) to remote Fly Agent MCP server (SSE).
+ *
+ * Usage:
+ *   FLY_API_KEY=fly_sk_xxx node index.js
+ */
+
+import { Client } from "@modelcontextprotocol/sdk/client/index.js";
+import { SSEClientTransport } from "@modelcontextprotocol/sdk/client/sse.js";
+import { Server } from "@modelcontextprotocol/sdk/server/index.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import {
+  ListToolsRequestSchema,
+  CallToolRequestSchema,
+  ListResourcesRequestSchema,
+  ReadResourceRequestSchema,
+  ListPromptsRequestSchema,
+  GetPromptRequestSchema,
+} from "@modelcontextprotocol/sdk/types.js";
+
+const API_KEY = process.env.FLY_API_KEY;
+const FLY_ENV = process.env.FLY_ENV || "dev";
+
+// Map FLY_ENV to Cloud Run URLs
+const ENV_URLS = {
+  dev: "https://fly-agent-dev-mcp-681315111540.asia-south1.run.app/mcp/sse",
+  staging: "https://fly-agent-staging-681315111540.asia-south1.run.app/mcp/sse",
+  main: "https://fly-agent-main-681315111540.asia-south1.run.app/mcp/sse",
+};
+
+const MCP_URL = process.env.FLY_MCP_URL || ENV_URLS[FLY_ENV] || ENV_URLS.dev;
+
+if (!API_KEY) {
+  console.error("Error: FLY_API_KEY environment variable required");
+  process.exit(1);
+}
+
+// Create local stdio server
+const server = new Server(
+  { name: "fly-agent-proxy", version: "1.0.0" },
+  { capabilities: { tools: {}, resources: {}, prompts: {} } }
+);
+
+// Remote client
+let remoteClient = null;
+
+async function connectToRemote() {
+  if (remoteClient) return remoteClient;
+
+  console.error("Connecting to remote MCP server...");
+
+  const transport = new SSEClientTransport(new URL(MCP_URL), {
+    requestInit: {
+      headers: {
+        "X-API-Key": API_KEY,
+      },
+    },
+  });
+
+  remoteClient = new Client(
+    { name: "fly-agent-proxy-client", version: "1.0.0" },
+    { capabilities: {} }
+  );
+
+  await remoteClient.connect(transport);
+  console.error("Connected to remote MCP server:", MCP_URL);
+  return remoteClient;
+}
+
+// Proxy tool listing
+server.setRequestHandler(ListToolsRequestSchema, async () => {
+  const client = await connectToRemote();
+  return await client.listTools();
+});
+
+// Proxy tool calls
+server.setRequestHandler(CallToolRequestSchema, async (request) => {
+  const client = await connectToRemote();
+  return await client.callTool(request.params);
+});
+
+// Proxy resource listing
+server.setRequestHandler(ListResourcesRequestSchema, async () => {
+  const client = await connectToRemote();
+  return await client.listResources();
+});
+
+// Proxy resource reading
+server.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+  const client = await connectToRemote();
+  return await client.readResource(request.params);
+});
+
+// Proxy prompt listing
+server.setRequestHandler(ListPromptsRequestSchema, async () => {
+  const client = await connectToRemote();
+  return await client.listPrompts();
+});
+
+// Proxy prompt getting
+server.setRequestHandler(GetPromptRequestSchema, async (request) => {
+  const client = await connectToRemote();
+  return await client.getPrompt(request.params);
+});
+
+// Start the local stdio server
+async function main() {
+  const transport = new StdioServerTransport();
+  await server.connect(transport);
+  console.error(`MCP proxy started - env: ${FLY_ENV}, bridging to`, MCP_URL);
+}
+
+main().catch((error) => {
+  console.error("Fatal error:", error);
+  process.exit(1);
+});

package/package.json

@@ -0,0 +1,33 @@
+{
+  "name": "fly-agent-mcp",
+  "version": "1.0.0",
+  "description": "MCP proxy for Fly Agent - connects Claude Desktop to Fly Agent's remote MCP server",
+  "main": "index.js",
+  "type": "module",
+  "bin": {
+    "fly-mcp": "./index.js"
+  },
+  "scripts": {
+    "start": "node index.js"
+  },
+  "keywords": [
+    "mcp",
+    "model-context-protocol",
+    "fly-agent",
+    "claude",
+    "google-business-profile",
+    "gbp"
+  ],
+  "author": "Fly Social",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/ZoomLocal-Tech/fly-agent"
+  },
+  "engines": {
+    "node": ">=18.0.0"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0"
+  }
+}