Pocha MCP Server

Pocha MCP サーバー

Pocha プロジェクト向けに TypeScript API 関数を生成する Model Context Protocol（MCP）サーバーです。一貫したパターンに従って、型安全な API 関数のテンプレートを自動生成するツールを提供します。

特長

• 適切な型付けを備えた TypeScript API 関数を生成します
• GET、POST、PUT、DELETE の HTTP メソッドに対応します
• 認証トークンの処理を含みます
• 適切なエラー処理とレスポンスの型付けを生成します
• オプションのパラメーターと戻り値の型に対応します

インストール

# Clone the repository
git clone https://github.com/jiohjung98/pocha-mcp-server.git

# Install dependencies
pnpm install

# Build the project
pnpm build

使用方法

このサーバーは、以下のパラメーターを受け取る generate-api-function というツールを提供します。

{
  functionName: string;          // Name of the API function to generate
  route: string;                 // API route path (e.g., "/pocha/${pochaid}")
  method: "GET" | "POST" | "PUT" | "DELETE";  // HTTP method
  params?: {                     // Optional array of parameters
    name: string;               // Parameter name
    type: string;               // Parameter type
  }[];
  returnType: string;           // Return type of the API function
}

例

Pocha の情報を取得する API 関数を生成するには：

// Input parameters
{
  "functionName": "getPocha",
  "route": "/pocha/${pochaid}",
  "method": "GET",
  "params": [
    {
      "name": "pochaid",
      "type": "number"
    }
  ],
  "returnType": "PochaInfo"
}

// Generated output
/**
 * @desc getPocha
 * @route GET /pocha/${pochaid}
 */
export async function getPocha(pochaid: number, token: string): Promise<PochaInfo> {
  const url = `/pocha/${pochaid}`;
  try {
    const response = await client.get(url, {
      headers: {
        Authorization: `Bearer ${token}`,
      },
    });

    return response?.data;
  } catch (error) {
    console.log(error);
    throw new Error("Error in getPocha");
  }
}

開発

このサーバーは以下を使用して構築されています：

• TypeScript
• MCP TypeScript SDK
• スキーマ検証用の Zod

開発を開始するには：

# Install dependencies
pnpm install

# Build in watch mode
pnpm dev

プロジェクト構成

pocha-mcp-server/
├── src/
│   └── index.ts     # Main server implementation
├── dist/            # Compiled JavaScript
├── package.json
└── tsconfig.json

Cursor の設定

この MCP サーバーを Cursor IDE で使用するには：

1. Cursor の MCP 設定ファイルを開きます：

   # macOS
   ~/.cursor/mcp.json
   
   # Windows
   %APPDATA%/cursor/mcp.json
   
   # Linux
   ~/.cursor/mcp.json
   

2. mcpServers オブジェクトに以下の設定を追加します：

   {
     "mcpServers": {
       "pocha-api-generator": {
         "command": "/opt/homebrew/bin/npx",
         "args": ["-y", "node", "/path/to/your/pocha-mcp-server/dist/index.js"]
       }
     }
   }
   

   /path/to/your/pocha-mcp-server を、このリポジトリをクローンした実際のパスに置き換えます。

3. 変更を反映するために Cursor を再起動します。

4. これで MCP サーバーを Cursor で利用できるようになり、次のような自然言語のコマンドを入力して API 関数を生成できます：

   Can you create a sample API for pocha project that fetches PochaInfo from "/pocha/${pochaid}" using "pocha-api-generator" mcp?
   

ライセンス

MIT ライセンス