McpServerBasic

Hello MCP Server

This is a Model Context Protocol (MCP) server implementation that enables AI assistants to interact with external services and data sources. The server is designed to work with Claude and other MCP-compatible AI assistants.

Prerequisites

• Node.js (v18 or higher)
• pnpm package manager
• force CLI, install with pnpm i -g @forgehive/forge-cli

Installation

Clone the repository and install dependencies:

git clone <repository-url>
cd hello-mcp-server
pnpm install

Build

Build the project with:

pnpm run build

This will compile TypeScript into JavaScript in the dist directory.

Running Tasks Directly

You can run individual tasks directly using the Forge runner:

# Run the stock price task with a ticker parameter
forge task:run stock:price --ticker AAPL

Adding to Claude Desktop

To use the server with Claude Desktop:

1. Build the project with pnpm run build
2. Modify the Claude Desktop configuration file:

With nano: ~/Library/Application Support/Claude/claude_desktop_config.json

{
    "mcpServers": {
        "hello-mcp-server": {
            "command": "node",
            "args": [
                "ABSOLUTE_PATH_TO_PROJECT/hello-mcp-server/dist/index.js"
            ]
        }
    }
}

Replace ABSOLUTE_PATH_TO_PROJECT with the actual absolute path to your project directory.

Using MCP Inspector

For debugging and testing your MCP server, you can use the MCP Inspector tool:

npx @modelcontextprotocol/inspector ABSOLUTE_PATH_TO_PROJECT/hello-mcp-server/dist/index.js

The inspector provides a web interface to test your server's tools and see their responses.

Development

To add new tasks:

1. Create a new task using the Forge CLI:

   forge task:create MODULE:TASK_NAME
   

   This will generate a task template file in src/tasks/MODULE/TASK_NAME.ts.

2. Implement your task in the generated file using the Forge Task API.

3. Register the task in the runner (src/runner.ts):

   import { yourTask } from './tasks/module/your-task';
   
   // Add your task to the runner
   runner.load('your_task_name', yourTask);
   

4. Build the project with pnpm run build

The server will automatically register all tasks from the runner as MCP tools without needing to manually add them to the src/index.ts file.

Additional Resources

• Model Context Protocol Documentation
• MCP Quickstart Guide