Mcpserverbasic

🚀 Hello MCP Server

This is a server that implements the Model Context Protocol (MCP), allowing AI assistants to interact with external services and data sources. The server is designed for Claude and other MCP-compatible AI assistants.

🚀 Quick Start

✨ Features

• Enables AI assistants to interact with external services and data sources through MCP.
• Designed specifically for Claude and other MCP-compatible AI assistants.

📦 Installation

Prerequisites

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

Clone the repository and install dependencies:

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

📚 Documentation

Build

Build the project using the following command:

pnpm run build

This will compile the TypeScript code to JavaScript and output it to the dist directory.

Run a Task Directly

You can run a single task directly using the Forge runner:

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

Add to Claude Desktop

To use the server in Claude Desktop:

1. Build the project using pnpm run build.
2. Modify the Claude Desktop configuration file: Open it 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 of your project.

Use the MCP Inspector

To debug and test 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 tools and their responses.

Development

To add a new task:

1. Create a new task using the Forge CLI:

   forge task:create MODULE:TASK_NAME
   

   This will generate a task template file at src/tasks/MODULE/TASK_NAME.ts.
2. Implement your task using the Forge Task API in the generated file.
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 using pnpm run build. The server will automatically register all tasks from the runner as MCP tools without manually adding them in the src/index.ts file.

📄 Additional Resources

• Model Context Protocol Documentation
• MCP Quick Start Guide