模型上下文协议服务器

你好MCP服务器

这是一个模型上下文协议（MCP）服务器实现，使AI助手能够与外部服务和数据源进行交互。该服务器旨在与Claude和其他兼容MCP的AI助手配合使用。

先决条件

• Node.js（v18或更高版本）
• pnpm包管理器
• force CLI，安装时使用 pnpm i -g @forgehive/forge-cli

安装

克隆存储库并安装依赖项：

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

构建

使用以下内容构建项目：

pnpm run build

这将把TypeScript编译成JavaScript dist 目录。

直接运行任务

您可以直接使用Forge运行器运行单个任务：

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

添加到Claude桌面

要将服务器与Claude Desktop一起使用，请执行以下操作：

1. 用以下方式构建项目 pnpm run build
2. 修改Claude Desktop配置文件：

随着 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"
            ]
        }
    }
}

替换 ABSOLUTE_PATH_TO_PROJECT 使用项目目录的实际绝对路径。

使用MCP检查器

为了调试和测试您的MCP服务器，您可以使用MCP检查器工具：

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

检查器提供了一个web界面来测试服务器的工具并查看它们的响应。

发展

要添加新任务，请执行以下操作：

1. 使用Forge CLI创建新任务：

   复制

   forge task:create MODULE:TASK_NAME
   

   这将在中生成一个任务模板文件 src/tasks/MODULE/TASK_NAME.ts.

2. 使用Forge task API在生成的文件中实现您的任务。

3. 在runner中注册任务（src/runer.ts）：

   复制

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

4. 用以下方式构建项目 pnpm run build

服务器将自动将运行器中的所有任务注册为MCP工具，而无需手动将其添加到 src/index.ts 文件。

额外资源

• 模型上下文协议文档
• MCP快速入门指南