Hello MCP Server K7b

🚀 Welcome to the MCP Server

This is a server implementing the Model Context Protocol (MCP), which allows AI assistants to interact with external services and data sources. The server is designed to work with Claude and other MCP-compatible AI assistants.

🚀 Quick Start

✨ Features

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

📦 Installation

Prerequisites

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

Clone the repository and install dependencies:

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

🛠️ Build

Build the project using the following command:

pnpm run build

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

💻 Usage Examples

Directly Run a Task

You can use the Forge runner to directly run a single task:

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

Add to Claude Desktop

To use the server with Claude Desktop:

1. Build the project using pnpm run build.
2. Modify the Claude Desktop configuration file: Open it with the nano editor: ~/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 the 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 the server's tools and view its 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 located at src/tasks/MODULE/TASK_NAME.ts. 2. Implement your task in the generated file using the Forge Task API. 3. Load 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 load all tasks from the runner as MCP tools, without the need to manually add them in the src/index.ts file.