远程MCP服务器

一个基于Cloudflare Workers和Hono框架构建的简单远程MCP服务器,提供素因数分解工具。

  • by aoki-collabo
  • TypeScript
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 aoki-collabo/simple-hono-mcp-server

使用说明

简单mcp服务器

Cloudflare和Hono制作的最简单的远程MCP服务器。

概要

此项目包括:MCP(模型上下文协议) 示例实现,使服务器在云流工作人员上运行。它表明可以使用Hono框架以最少的代码构建MCP服务器。

提供的工具

因式分解

正整数的素因数分解工具。

入力:

  • number:素因数分解的正整数(1以上、15位以下)

出力:

  • 因子列表
  • 除法次数

例:

入力: 12
出力: 12の素因数分解結果:
素因数: [2, 2, 3]
割り算回数: 3回

前提条件

  • Node.js v18以上
  • 云流帐户(如果要部署)

安装,安装

# リポジトリのクローン
git clone <repository-url>
cd simple-mcp-server

# 依存関係のインストール
npm install

本地运行

npm run dev

服务器 http://localhost:8787 中所述修改相应参数的值。MCP端点是 http://localhost:8787/mcp 是。

测试

npm test

部署到云流

# Cloudflareにログイン(初回のみ)
npx wrangler login

# デプロイ
npm run deploy

部署后https://<your-worker>.workers.dev/mcp 中所述修改相应参数的值。

从MCP客户端连接

Claude 桌面版

claude_desktop_config.json 添加:

{
  "mcpServers": {
    "simple-mcp-server": {
      "url": "http://localhost:8787/mcp"
    }
  }
}

部署后 url 将其更改为Cloudflare Workers的URL。

Claude 代码

claude mcp add simple-mcp-server http://localhost:8787/mcp --transport http

动作确认

curl确认:

# ツール一覧の取得
curl -X POST http://localhost:8787/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "method": "tools/list", "id": 1}'

# 素因数分解の実行
curl -X POST http://localhost:8787/mcp \
  -H "Content-Type: application/json" \
  -H "Accept: application/json, text/event-stream" \
  -d '{"jsonrpc": "2.0", "method": "tools/call", "params": {"name": "factorize", "arguments": {"number": 12}}, "id": 2}'

技术栈

许可证

麻省理工学院

许可证通知

Claude Code相关文档(.claude/、.steering/等)表示 生成代理/claude-code-book适配器8 中所述修改相应参数的值。