Mcpframework Http Server

🚀 Team Evolve HTTP MCP Server

A Model Context Protocol (MCP) server built with the mcp-framework.

🚀 Quick Start

# Install dependencies
npm install

# Build the project
npm run build

✨ Features

Project Structure

team-evolve-http-mcpserver/
├── src/
│   ├── tools/        # MCP tools
│   │   └── ExampleTool.ts
│   └── index.ts      # Server entry file
├── package.json
└── tsconfig.json

Adding Components

The project comes with an example tool at src/tools/ExampleTool.ts. You can add more tools via the CLI:

# Add a new tool
mcp add tool my-tool

# Example tools you might create:
mcp add tool data-processor
mcp add tool api-client
mcp add tool file-handler

Tool Development

Example tool structure:

import { MCPTool } from "mcp-framework";
import { z } from "zod";

interface MyToolInput {
  message: string;
}

class MyTool extends MCPTool<MyToolInput> {
  name = "my_tool";
  description = "Describe the functionality of your tool";

  schema = {
    message: {
      type: z.string(),
      description: "Description of this input parameter",
    },
  };

  async execute(input: MyToolInput) {
    // Your tool logic goes here
    return `Processed: ${input.message}`;
  }
}

export default MyTool;

Publishing to npm

1. Update package.json:

   • Ensure the name is unique and follows npm naming conventions.
   • Set an appropriate version.
   • Add information such as description, author, license, etc.
   • Check that bin points to the correct entry file.

2. Build and test locally:

   npm run build
   npm link
   team-evolve-http-mcpserver  # Test your CLI locally
   

3. Log in to npm (create an account if needed):

   npm login
   

4. Publish your package:

   npm publish
   

After publishing, users can add it to their Claude desktop client (read the instructions below) or run it using npx.

Working with Claude Desktop

Local Development

Add the following configuration to your Claude Desktop configuration file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "team-evolve-http-mcpserver": {
      "command": "node",
      "args":["/absolute/path/to/team-evolve-http-mcpserver/dist/index.js"]
    }
  }
}

After Publishing

Add the following configuration to your Claude Desktop configuration file:

MacOS: ~/Library/Application Support/Claude/claude_desktop_config.json Windows: %APPDATA%/Claude/claude_desktop_config.json

{
  "mcpServers": {
    "team-evolve-http-mcpserver": {
      "command": "npx",
      "args": ["team-evolve-http-mcpserver"]
    }
  }
}

Building and Testing

1. Modify your tool.
2. Run npm run build to compile.
3. The server will automatically load your tool after startup.

📚 Documentation

More Information

• MCP Framework Github
• MCP Framework Documentation