ping-mcp-server 0.1.4 → 0.1.5

package/package/src/init.ts

@@ -0,0 +1,302 @@
+#!/usr/bin/env node
+/**
+ * PING INIT SCRIPT
+ * ================
+ *
+ * Sets up Ping for first-time users:
+ * - Shows welcome banner
+ * - Checks API connectivity
+ * - Creates config directory
+ * - Offers to add Ping to Claude Code config
+ */
+
+import * as fs from 'fs';
+import * as path from 'path';
+import * as os from 'os';
+import * as readline from 'readline';
+
+// ============================================================
+// CONFIGURATION
+// ============================================================
+
+const API_BASE_URL = process.env.PING_API_URL || 'https://api.ping-money.com';
+const CONFIG_DIR = path.join(os.homedir(), '.ping');
+const CONFIG_FILE = path.join(CONFIG_DIR, 'config.json');
+
+// Possible Claude Code config locations
+const CLAUDE_CONFIG_PATHS = [
+  path.join(os.homedir(), '.claude', 'settings.json'),
+];
+
+// ============================================================
+// BANNER
+// ============================================================
+
+const BANNER = `
++------------------------------------------+
+|                                          |
+|   ____  _                                |
+|  |  _ \\(_)_ __   __ _                    |
+|  | |_) | | '_ \\ / _\` |                   |
+|  |  __/| | | | | (_| |                   |
+|  |_|   |_|_| |_|\\__, |                   |
+|                 |___/                    |
+|                                          |
+|  Answer questions. Earn crypto.          |
+|                                          |
++------------------------------------------+
+`;
+
+// ============================================================
+// HELPERS
+// ============================================================
+
+function print(message: string) {
+  console.log(message);
+}
+
+function printSuccess(message: string) {
+  console.log(`[OK] ${message}`);
+}
+
+function printError(message: string) {
+  console.log(`[ERROR] ${message}`);
+}
+
+function printInfo(message: string) {
+  console.log(`[INFO] ${message}`);
+}
+
+async function prompt(question: string): Promise<string> {
+  const rl = readline.createInterface({
+    input: process.stdin,
+    output: process.stdout,
+  });
+
+  return new Promise((resolve) => {
+    rl.question(question, (answer) => {
+      rl.close();
+      resolve(answer.trim().toLowerCase());
+    });
+  });
+}
+
+// ============================================================
+// API CHECK
+// ============================================================
+
+async function checkApiConnectivity(): Promise<boolean> {
+  try {
+    const response = await fetch(`${API_BASE_URL}/health`);
+    return response.ok;
+  } catch {
+    return false;
+  }
+}
+
+// ============================================================
+// CONFIG SETUP
+// ============================================================
+
+function createConfigDirectory(): boolean {
+  try {
+    if (!fs.existsSync(CONFIG_DIR)) {
+      fs.mkdirSync(CONFIG_DIR, { recursive: true });
+      printSuccess(`Created config directory: ${CONFIG_DIR}`);
+    } else {
+      printInfo(`Config directory already exists: ${CONFIG_DIR}`);
+    }
+    return true;
+  } catch (error) {
+    printError(`Failed to create config directory: ${error}`);
+    return false;
+  }
+}
+
+function initializeConfig(): boolean {
+  try {
+    if (!fs.existsSync(CONFIG_FILE)) {
+      fs.writeFileSync(CONFIG_FILE, JSON.stringify({}, null, 2));
+      printSuccess(`Created config file: ${CONFIG_FILE}`);
+    } else {
+      printInfo(`Config file already exists: ${CONFIG_FILE}`);
+    }
+    return true;
+  } catch (error) {
+    printError(`Failed to create config file: ${error}`);
+    return false;
+  }
+}
+
+// ============================================================
+// CLAUDE CODE INTEGRATION
+// ============================================================
+
+function findClaudeCodeConfig(): string | null {
+  for (const configPath of CLAUDE_CONFIG_PATHS) {
+    if (fs.existsSync(configPath)) {
+      return configPath;
+    }
+  }
+  return null;
+}
+
+function findClaudeCodeConfigDir(): string | null {
+  // Find an existing config, or default to the most common location
+  const existingConfig = findClaudeCodeConfig();
+  if (existingConfig) {
+    return path.dirname(existingConfig);
+  }
+
+  // Default location for Claude Code config
+  const defaultDir = path.join(os.homedir(), '.claude');
+  return defaultDir;
+}
+
+interface ClaudeCodeConfig {
+  mcpServers?: {
+    [key: string]: {
+      type: string;
+      command: string;
+      args?: string[];
+      env?: Record<string, string>;
+    };
+  };
+  [key: string]: unknown;
+}
+
+function addToClaudeCodeConfig(configPath: string): boolean {
+  try {
+    const configDir = path.dirname(configPath);
+
+    // Ensure config directory exists
+    if (!fs.existsSync(configDir)) {
+      fs.mkdirSync(configDir, { recursive: true });
+    }
+
+    // Load existing config or create empty one
+    let config: ClaudeCodeConfig = {};
+    if (fs.existsSync(configPath)) {
+      const content = fs.readFileSync(configPath, 'utf-8');
+      config = JSON.parse(content);
+    }
+
+    // Initialize mcpServers if it doesn't exist
+    if (!config.mcpServers) {
+      config.mcpServers = {};
+    }
+
+    // Check if Ping is already configured
+    if (config.mcpServers.ping) {
+      printInfo('Ping MCP server is already configured in Claude Code');
+      return true;
+    }
+
+    // Add Ping MCP server
+    // -p flag tells npx which package to install, then runs the ping-mcp binary from it
+    config.mcpServers.ping = {
+      type: 'stdio',
+      command: 'npx',
+      args: ['-y', '-p', 'ping-mcp-server', 'ping-mcp'],
+    };
+
+    // Write updated config
+    fs.writeFileSync(configPath, JSON.stringify(config, null, 2));
+    printSuccess(`Added Ping MCP server to: ${configPath}`);
+    return true;
+  } catch (error) {
+    printError(`Failed to update Claude Code config: ${error}`);
+    return false;
+  }
+}
+
+// ============================================================
+// MAIN
+// ============================================================
+
+async function main() {
+  print(BANNER);
+  print('Welcome to Ping! Let\'s get you set up.\n');
+
+  // Step 1: Check API connectivity
+  print('Checking API connectivity...');
+  const apiOk = await checkApiConnectivity();
+  if (apiOk) {
+    printSuccess(`Connected to ${API_BASE_URL}`);
+  } else {
+    printError(`Could not reach ${API_BASE_URL}`);
+    printInfo('The API may be temporarily unavailable. You can continue setup.');
+  }
+  print('');
+
+  // Step 2: Create config directory
+  print('Setting up local configuration...');
+  const dirOk = createConfigDirectory();
+  if (!dirOk) {
+    printError('Setup failed. Please check permissions and try again.');
+    process.exit(1);
+  }
+
+  // Step 3: Initialize config file
+  const configOk = initializeConfig();
+  if (!configOk) {
+    printError('Setup failed. Please check permissions and try again.');
+    process.exit(1);
+  }
+  print('');
+
+  // Step 4: Claude Code integration
+  print('Looking for Claude Code configuration...');
+  const claudeConfigPath = findClaudeCodeConfig();
+  const claudeConfigDir = findClaudeCodeConfigDir();
+
+  if (claudeConfigPath) {
+    printInfo(`Found Claude Code config: ${claudeConfigPath}`);
+  } else if (claudeConfigDir) {
+    printInfo(`Will create Claude Code config at: ${path.join(claudeConfigDir, 'settings.json')}`);
+  }
+
+  const targetConfigPath = claudeConfigPath || path.join(claudeConfigDir!, 'settings.json');
+
+  print('');
+  const answer = await prompt('Add Ping MCP server to Claude Code? (y/n): ');
+
+  if (answer === 'y' || answer === 'yes') {
+    const added = addToClaudeCodeConfig(targetConfigPath);
+    if (!added) {
+      printInfo('You can manually add Ping to your Claude Code config later.');
+    }
+  } else {
+    printInfo('Skipped Claude Code integration.');
+    printInfo('You can manually add this to your ~/.claude/settings.json:');
+    print('');
+    print('  {');
+    print('    "mcpServers": {');
+    print('      "ping": {');
+    print('        "type": "stdio",');
+    print('        "command": "npx",');
+    print('        "args": ["-y", "-p", "ping-mcp-server", "ping-mcp"]');
+    print('      }');
+    print('    }');
+    print('  }');
+  }
+
+  // Step 5: Success message
+  print('');
+  print('+------------------------------------------+');
+  print('|                                          |');
+  print('|  Setup complete!                         |');
+  print('|                                          |');
+  print('|  Next steps:                             |');
+  print('|  1. Restart Claude Code                  |');
+  print('|  2. Say "ping_login" to connect GitHub   |');
+  print('|  3. Start earning!                       |');
+  print('|                                          |');
+  print('+------------------------------------------+');
+  print('');
+}
+
+main().catch((error) => {
+  printError(`Unexpected error: ${error}`);
+  process.exit(1);
+});

package/package/tsconfig.json

@@ -0,0 +1,8 @@
+{
+  "extends": "../../tsconfig.json",
+  "compilerOptions": {
+    "outDir": "dist",
+    "rootDir": "src"
+  },
+  "include": ["src/**/*"]
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ping-mcp-server",
-  "version": "0.1.4",
+  "version": "0.1.5",
   "description": "MCP server that gives Claude Code the ability to interact with Ping",
   "type": "module",
   "bin": {

package/src/index.ts

@@ -741,6 +741,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         name: 'ping_login',
         description:
           'Login to Ping with GitHub. Opens a browser window for GitHub OAuth authentication. ' +
+          'TRIGGERS: "ping login", "login to ping", "connect to ping", "sign in to ping", "start using ping". ' +
           'Use when the user wants to login, sign in, connect their account, or start using Ping. ' +
           'After login, a wallet will be automatically created for the user.',
         inputSchema: {
@@ -798,6 +799,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         name: 'ping_check_earnings',
         description:
           'Check your Ping earnings - shows pending balance (ready to claim) and total claimed. ' +
+          'TRIGGERS: "ping earnings", "ping balance", "how much have I earned", "check my ping", "my earnings". ' +
           'Use when the user asks about their balance, earnings, or how much money they have. ' +
           'Requires wallet to be set first with ping_set_wallet.',
         inputSchema: {
@@ -853,6 +855,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         name: 'ping_answer_flow',
         description:
           'Start an interactive Q&A session to earn money answering Ping questions. ' +
+          'TRIGGERS: "ping", "/ping", "answer questions", "earn money", "make money with ping", "start earning". ' +
           'Returns questions with suggested answers. ' +
           'CRITICAL: Present ALL questions in a SINGLE AskUserQuestion call (batched) to reduce latency. ' +
           'Use the questions array parameter with multiple question objects. ' +
@@ -874,6 +877,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
         name: 'ping_claim_reward',
         description:
           'Claim pending Ping earnings and send them to your crypto wallet on Base. ' +
+          'TRIGGERS: "claim my ping", "withdraw from ping", "cash out", "get my money", "claim rewards". ' +
           'Use when the user wants to withdraw, cash out, or claim their rewards. ' +
           'Transfers USDC to their wallet instantly. ' +
           'Works with GitHub login (ping_login) or legacy wallet (ping_set_wallet).',