Siedrix/hello-mcp-server
If you are the rightful owner of hello-mcp-server and would like to certify it and/or have it hosted online, please leave a comment on the right or send an email to henry@mcphub.com.
This is a Model Context Protocol (MCP) server implementation that enables AI assistants to interact with external services and data sources.
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:
- Build the project with
pnpm run build - 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:
-
Create a new task using the Forge CLI:
forge task:create MODULE:TASK_NAMEThis will generate a task template file in
src/tasks/MODULE/TASK_NAME.ts. -
Implement your task in the generated file using the Forge Task API.
-
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); -
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.
