MCP服令

工具

工具是供LLM请求使用的，例如Claude Desktop应用程序。Claude Sonnet 3.5智能地使用了这两种工具，这让我感到非常惊喜。

• run_command - 运行命令，如 hostname 或 ls -al 或 echo "hello world" 等
  • 返回STDOUT和STDERR作为文本
• run_script - 运行脚本！（例如 fish, bash, zsh, python）
  • 让你的LLM运行它编写的代码！
  • 脚本通过STDIN传递
  • run_script == run_command + 通过STDIN传递的脚本
  • Claude在这方面相当有创意，例如使用cat作为解释器来创建新文件！

[!WARNING]
请小心你要求此服务器执行的内容！
在Claude Desktop应用中，使用Approve Once（而非Allow for This Chat），以便你可以审查每个命令，如果你不信任该命令，请使用Deny。
权限由运行服务器的用户决定。
请勿使用sudo运行。

视频演示

提示词

提示词供用户包含在聊天记录中，例如通过Zed的斜杠命令（在其AI聊天面板中）

• run_command - 生成包含命令输出的提示消息

开发

安装依赖项：

npm install

构建服务器：

npm run build

对于带有自动重建的开发：

npm run watch

安装

要与Claude Desktop一起使用，请添加服务器配置：

在MacOS上：~/Library/Application Support/Claude/claude_desktop_config.json
在Windows上：%APPDATA%/Claude/claude_desktop_config.json

使用已发布的npm包

作为mcp-server-commands发布到npm，使用此工作流

{
  "mcpServers": {
    "mcp-server-commands": {
      "command": "npx",
      "args": ["mcp-server-commands"]
    }
  }
}

使用本地构建（仓库检出）

{
  "mcpServers": {
    "mcp-server-commands": {
      // works b/c of shebang in index.js
      "command": "/path/to/mcp-server-commands/build/index.js"
    }
  }
}

日志记录

Claude Desktop应用程序将日志写入~/Library/Logs/Claude/mcp-server-mcp-server-commands.log

默认情况下，只记录重要信息（例如错误）。
如果你想看到更多信息，请在配置服务器时向args添加--verbose。

顺便说一下，日志被写入STDERR，因为这是Claude Desktop路由到日志文件的方式。
未来，我预计格式良好的日志消息将通过STDIO传输到MCP客户端（注意：不是Claude Desktop应用程序）。

调试

由于MCP服务器通过stdio通信，调试可能具有挑战性。我们建议使用MCP Inspector，它作为一个包脚本提供：

npm run inspector

Inspector将提供一个URL，让你可以在浏览器中访问调试工具。