AI导哈

本地工具协议服务器

MCP Tools是一个本地模型上下文协议服务器，为Claude Desktop提供自定义工具，使其能够直接与本地环境交互。

  • by joehuangcoding
  • TypeScript
  • 本地部署
  • 更新于
在 GitHub 查看 joehuangcoding/mcp-tools

使用说明

🛠️ MCP工具

本地人 模型上下文协议（MCP） 该服务器向Claude Desktop公开自定义工具，使Claude能够直接与您的本地环境交互。

📋 先决条件

在开始之前，请确保已安装以下内容：

🚀 设置

1.安装依赖项

打开终端，导航到项目文件夹，然后安装：

cd <project-path>
npm install

2.建设项目

编译TypeScript源代码：

npm run build

这将在 dist/ 文件夹（通常 dist/index.js).

3.配置克劳德桌面

Claude Desktop需要了解您的MCP服务器。在以下位置打开（或创建）配置文件：

%APPDATA%\Claude\claude_desktop_config.json

提示： 您可以按快速打开它 Win + R，打字 %APPDATA%\Claude，然后按Enter键。

粘贴以下配置：

{
  "mcpServers": {
    "mcp-tools": {
      "command": "node",
      "args": [
        "<project-path>/dist/index.js"
      ]
    }
  }
}

注： 替换 <project-path> 带有项目文件夹的实际路径（例如。 C:\\Users\\username\\Desktop\\mcp-tools).如果您的配置中已经有其他MCP服务器，请添加 "mcp-tools" 作为内部的新入口 "mcpServers" --不要替换整个文件。

4.重新启动克劳德桌面

完全退出并重新启动Claude Desktop，以便它采用新的配置。

在Windows上，确保右键单击系统托盘图标并选择 退出 --仅仅关闭窗口可能会让它在后台运行。

✅ 验证连接

一旦Claude Desktop重新启动：

  1. 打开新聊天
  2. 点击 🔧 工具 输入框左下角的图标（锤子图标）
  3. 你应该看看你的 mcp-tools 列出并可用的工具

如果工具未显示，请参阅 故障排除 在......下面

💬 使用工具

一旦连接，你可以让克劳德在对话中自然地使用你的工具。例如：

"Can you use the mcp-tools to..."

Claude将自动检测工具何时相关，并代表您调用它。

🔄 进行更改

如果您修改了任何源文件，请重建并重新启动Claude Desktop：

npm run build

然后完全重新启动Claude Desktop以使更改生效。

🐛 故障排除

工具未显示在Claude Desktop中

  • 仔细检查路径 claude_desktop_config.json 与您的实际项目位置完全匹配（注意单反斜杠和双反斜杠）
  • 确保 npm run build 已完成，无任何错误 dist/index.js 存在
  • 完全退出并重新启动Claude Desktop（检查系统托盘）
  • 通过以下方式打开克劳德桌面日志 Help → 打开日志文件夹 查找MCP错误

构建错误

# Make sure dependencies are installed
npm install

# Check your Node version (needs v18+)
node --version

未找到配置文件

如果 %APPDATA%\Claude\ 尚不存在，请创建文件夹和 claude_desktop_config.json 手动文件。

📂 项目结构

mcp-tools/
├── src/
│   └── index.ts          # Main MCP server entry point
├── dist/                 # Compiled output (generated by build)
│   └── index.js
├── package.json
├── tsconfig.json
└── README.md

🔨 构建命令参考

编译TypeScript源代码的不同方法取决于您的设置：

# Recommended — bundle with esbuild (fastest, most compatible)
npx esbuild src/index.ts --bundle --platform=node --format=cjs --target=node18 --outfile=dist/index.js

# Alternative — compile with tsc directly
npx tsc index.ts --module commonjs --target ES2020 --esModuleInterop true --outDir dist

有用的参考资料

https://simplescraper.io/blog/how-to-mcp#core-使用express设置服务器

https://vercel.com/kb/guide/mcp-server-with-weather-tool-express

📜 许可证

麻省理工学院

相关 MCP