prospector-mcp-email-finder: Instructions file for Claude Code

MCP Server Development Guide

This is an MCP (Model Context Protocol) server template for MCPize hosting platform.

Project Structure

├── src/
│   └── index.ts      # Main server entry point
├── package.json      # Dependencies and scripts
├── tsconfig.json     # TypeScript configuration
├── mcpize.yaml       # MCPize deployment manifest
└── Dockerfile        # Container build instructions

Development Commands

npm install          # Install dependencies
npm run dev          # Run in development mode with hot reload
npm run build        # Compile TypeScript to JavaScript
npm start            # Run compiled server

MCP SDK Usage

This server uses @modelcontextprotocol/sdk with Streamable HTTP transport.

Registering Tools

server.registerTool(
  "tool-name",
  {
    title: "Human-readable title",
    description: "What this tool does",
    inputSchema: {
      param: z.string().describe("Parameter description"),
    },
    outputSchema: {
      result: z.string(),
    },
  },
  async ({ param }) => {
    const output = { result: "computed value" };
    return {
      content: [{ type: "text", text: JSON.stringify(output) }],
      structuredContent: output,
    };
  }
);

Registering Resources

Resources provide data that fills the context window:

server.registerResource(
  "resource://data",
  {
    name: "Data Resource",
    description: "Provides static or dynamic data",
    mimeType: "application/json",
  },
  async () => ({
    contents: [{ uri: "resource://data", text: JSON.stringify(data) }],
  })
);

Registering Prompts

server.registerPrompt(
  "prompt-name",
  { description: "Prompt description" },
  async () => ({
    messages: [{ role: "user", content: { type: "text", text: "..." } }],
  })
);

MCPize Configuration

The mcpize.yaml file controls deployment:

• runtime: Server runtime (typescript, python, php)
• entry: Main source file
• build.install: Install command
• build.command: Build command
• startCommand.type: Transport type (http)
• configSchema.source: Where to extract config schema from