Pocha MCP Server

🚀 Pocha MCP Server

A Model Context Protocol (MCP) server for generating TypeScript API functions for the Pocha project. This server provides a tool to automatically generate type-safe API function templates based on a consistent schema.

✨ Features

• Generate TypeScript API functions with correct types.
• Support GET, POST, PUT, and DELETE HTTP methods.
• Handle authentication tokens.
• Generate proper error handling and response types.
• Support optional parameters and return types.

📦 Installation

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

# Install dependencies
pnpm install

# Build the project
pnpm build

💻 Usage Examples

Basic Usage

The server provides a tool named generate-api-function that accepts the following parameters:

{
  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 parameter array
    name: string;               // Parameter name
    type: string;               // Parameter type
  }[];
  returnType: string;           // Function return type
}

Advanced Usage

Generate an API function to fetch Pocha information:

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

// Generated output
/**
 * @desc Get Pocha information
 * @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");
  }
}

🔧 Technical Details

The server is built using the following technologies:

• TypeScript
• MCP TypeScript SDK
• Zod for schema validation

To start development:

# Install dependencies
pnpm install

# Build in watch mode
pnpm dev

📚 Documentation

Project Structure

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

Cursor Setup

To use this MCP server in the Cursor IDE:

1. Open your Cursor MCP configuration file:

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

2. Add the following configuration to the mcpServers object:

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

   Replace /path/to/your/pocha-mcp-server with the actual path where you cloned the repository.
3. Restart Cursor for the changes to take effect.
4. Now, the MCP server will be available in Cursor, and you can generate API functions by entering natural language commands, for example:

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

📄 License

Please refer to the project's LICENSE file for licensing information.

👥 Contributors

• [Your Name] - Project author

🙏 Acknowledgments

Thanks to all contributors and those who provided feedback.