关于 🛠️ Simple MCP Example with Claude and a Local JSON HTTP Server
这是一个小型 MCP 服务示例,让 macOS 版 Claude 操作本地模拟 JSON 服务,演示通过 MCP 工具读取和插入帖子。
主要功能
- 01连接 Claude 与本地 JSON 服务
- 02支持检索帖子
- 03支持插入帖子
- 04提供 MCP Inspector 测试说明
适用场景
- 01使用本地模拟 API 试用 MCP 工具
- 02通过 Claude 测试帖子读取与插入
MCP 相关
向 MCP 客户端提供工具,以便向本地模拟 JSON 服务发送请求。
配置
本地服务的配置在各客户端中通用,复制后粘贴到客户端的 MCP 配置文件即可。
我们还没有获取到这个服务的安装包或远程地址,请按项目 README 中的说明安装。
工具
本地服务需要在你的电脑上运行后才能读取工具,维护者暂未提供工具列表。
详细介绍
🛠️ 使用 Claude 和本地 JSON HTTP 服务的简单 MCP 示例
本指南将带你完成一个基本设置:使用 Claude(MacOS 桌面版),通过 MCP(Model-Computer Protocol) 与本地 模拟 JSON 服务交互。
🧰 前提条件
🚀 分步设置
1. 安装依赖项
在项目根目录中安装所需的软件包:
npm install
npm run mock-api
npm run mcp-server
编辑 claude_desktop_config.json 文件(通常位于 ~/.claude/ 或应用的内部配置文件夹中),并添加 MCP 服务配置:
{
"mcpServers": {
"json-chat": {
"command": "node",
"args": ["/absolute/path/to/mcp-example/dist/index.js"]
}
}
}
-
重启 Claude
-
重启后,你应该会在 Claude 输入栏下方看到两个新的 MCP 工具,每个工具旁都有一个 🛠️ 锤子图标:
-
尝试向 Claude 输入类似这样的提示词:
"get all posts"
"insert a post with id 500, title "created by claude" and views 123"
Claude 将使用你配置的 MCP 工具向本地模拟服务发送实际请求。
向 Claude 输入提示词时,请确保 JSON 服务和 MCP 服务都在运行。
测试
运行
npx @modelcontextprotocol/inspector node build/index.js
随后,你应该能在 http://127.0.0.1:6274/#resources 查看所有可用资源
评论
一个开放协议,规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话,MCP 服务负责提供工具、资源和提示模板,两者通过标准消息通信,同一个服务可以被不同客户端复用。