Mcpserverbasic

🚀 你好 MCP 服务器

这是一个实现模型上下文协议（Model Context Protocol, MCP）的服务器，它允许 AI 助手与外部服务和数据源进行交互。该服务器专为 Claude 和其他与 MCP 兼容的 AI 助手设计，能为 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 运行器：

# 使用ticker参数运行股票价格任务
forge task:run stock:price --ticker AAPL

添加到 Claude 桌面

要在 Claude 桌面中使用该服务器：

1. 使用 pnpm run build 构建项目。
2. 修改 Claude 桌面配置文件： 使用 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

检查器提供一个网络界面来测试你的服务器工具及其响应。

💻 使用示例

基础用法

# 克隆仓库并安装依赖
git clone <repository-url>
cd hello-mcp-server
pnpm install

# 构建项目
pnpm run build

# 直接运行股票价格任务
forge task:run stock:price --ticker AAPL

高级用法

# 在 Claude 桌面中使用该服务器
pnpm run build
# 修改 Claude 桌面配置文件
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 替换为你项目的实际绝对路径。

🔧 技术细节

开发

要添加新任务：

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

forge task:create MODULE:TASK_NAME

这将在 src/tasks/MODULE/TASK_NAME.ts 生成一个任务模板文件。 2. 在生成的文件中使用 Forge Task API 实现你的任务。 3. 在运行器中注册任务（src/runner.ts）：

import { yourTask } from './tasks/module/your-task';

// 将你的任务添加到运行器
runner.load('your_task_name', yourTask);

4. 使用 pnpm run build 构建项目。 该服务器将自动从运行器中注册所有任务作为 MCP 工具，而无需手动在 src/index.ts 文件中添加它们。

📚 详细文档

额外资源

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