ClaudeLocalMCP.ts
@chiisen
自己為 Claude 寫本地端 MCP Server (TypeScript版) 很簡單,有手就行😁
Overview
What is ClaudeLocalMCP.ts?
ClaudeLocalMCP.ts 是一个为 Claude 桌面版设计的本地 MCP 服务器示例,通过 OpenWeatherMap API 让 Claude 能查询指定地区的实时天气信息。它演示了如何为 AI 安全地连接外部数据工具,使开发者可以快速为自己的 Claude 配置本地 MCP 服务。
How to use ClaudeLocalMCP.ts?
先安装 Claude 桌面版并开启开发者模式,然后在 claude_desktop_config.json 中添加 MCP 服务器配置,指定 Node.js 运行编译后的 JavaScript 文件以及 .env 文件的路径。用户需要在 .env 中填入 OpenWeatherMap 的 API 密钥,并在对话中询问地区天气,Claude 会请求用户确认执行 MCP 服务。
Key features of ClaudeLocalMCP.ts
- 让 Claude 能查询实时天气信息
- 使用免费公开的 OpenWeatherMap API
- 通过
.env文件管理 API 密钥 - 本地运行,数据安全可控
- 配置简单,仅需修改 JSON 文件
- 基于 Node.js,跨平台可运行
Use cases of ClaudeLocalMCP.ts
- 在 Claude 对话中直接获取某地的当前天气
- 开发者学习如何为 Claude 编写本地 MCP 服务器
- 测试和演示 MCP 协议的基本工作流程
- 作为模板,快速扩展其他数据查询工具
FAQ from ClaudeLocalMCP.ts
使用 ClaudeLocalMCP.ts 需要哪些先决条件?
需要安装 Claude 桌面版(开启开发者模式),注册 OpenWeatherMap 并获取免费 API 密钥,以及 Node.js 运行环境。
如何获取 OpenWeatherMap API 密钥?
前往 openweathermap.org 注册免费账户,然后在账户面板中生成 API 密钥,并将密钥填入项目 dist 文件夹内的 .env 文件中。
如何配置 ClaudeLocalMCP.ts 到 Claude 桌面版?
找到 claude_desktop_config.json(Windows 路径 C:\Users\用户名\AppData\Roaming\Claude),在 mcpServers 中添加名为 weather 的节点,指定命令为 node,参数为编译后的 index.js 路径及 envPath 变量。
如何查看 ClaudeLocalMCP.ts 的运行日志?
Windows 用户可以到 C:\Users\用户名\AppData\Roaming\Claude\logs 目录查看日志,以排查配置或 API 连接问题。
ClaudeLocalMCP.ts 有什么使用限制?
免费 OpenWeatherMap API 有调用次数和频率限制;Claude 需要用户每次对话确认授权 MCP 执行;环境依赖 Node.js 和网络连接。