Hello FastMCP

A simple FastMCP tool that returns "Hello FastMCP!" when called.

Installation

npm install hello-fastmcp

Usage

Starting the server

npx hello-fastmcp

Or directly with Node.js:

node -e "import('./server.js').then(module => { module.default.start({ transportType: 'httpStream', httpStream: { port: 4000 } }); })"

The server will start on http://localhost:4000/mcp

You can also specify a custom port with the PORT environment variable:

PORT=4000 npx hello-fastmcp

Using the tool

Once the server is running, you can connect to it using any MCP-compatible client and call the helloFastMCP tool which requires no parameters and returns "Hello FastMCP!".

Tool Details

• Tool Name: helloFastMCP
• Description: A simple tool that returns 'Hello FastMCP!'
• Parameters: None
• Return Value: "Hello FastMCP!"

API Endpoints

• MCP Endpoint: http://localhost:4000/mcp
• Health Check: http://localhost:4000/ready

Configuration Files

This package includes several configuration files to help you integrate with different AI tools:

• mcpserver.json - Generic MCP server configuration
• hello-fastmcp-config.json - Detailed configuration with tool specifications
• claude-config.json - Configuration for Claude Desktop

Integration with AI Tools

This MCP server can be integrated with various AI tools that support the Model Context Protocol, such as:

• GitHub Copilot
• Cursor
• Claude Desktop
• Other MCP-compatible development tools

Claude Desktop Integration

To use with Claude Desktop, add the following to your Claude configuration:

{
  "mcpServers": {
    "hello-fastmcp": {
      "command": "npx",
      "args": [
        "hello-fastmcp"
      ],
      "env": {
        "PORT": "4000"
      }
    }
  }
}

Manual Integration

For manual integration with any MCP-compatible tool, use the endpoint URL:

http://localhost:4000/mcp

Changelog

v1.1.1

• Fixed server startup issues when using npx
• Improved module import structure
• Updated default port to 4000 to avoid conflicts
• Enhanced compatibility with AI tools

v1.1.0

• Fixed server startup issues
• Improved error handling
• Updated default port to 3000
• Enhanced tool return format compatibility
• Added comprehensive configuration files for various AI tools

v1.0.0

• Initial release
• Basic helloFastMCP tool implementation

Requirements

• Node.js >= 18.0.0

License

MIT