Party Time MCP 服务器

一个简单的MCP服务器，当被询问当前时间时会回复“It's Party Time”。

概述

这是对MCP协议的简单实现，直接从标准输入读取并写入到标准输出。它注册了一个名为get-time的单个工具，并在调用该工具时始终以“It's Party Time”响应。

服务器实现了MCP协议，处理JSON-RPC消息并适当回应。

macOS安装说明

1. 构建可执行文件

首先构建可执行文件：

mix deps.get
mix escript.build

这将在项目目录中创建一个名为party_time_mcp的可执行文件。

确保它有执行权限：

chmod +x ./party_time_mcp

2. 配置Claude桌面

1. 打开你的Claude配置文件：

nano ~/.config/claude/settings.json

2. 在文件末尾添加以下内容以启用实验性功能：

{
  "experimental_features": {
    "custom_mcp_server": true
  }
}

3. 保存并退出编辑器。

3. 启动Claude桌面

启动Claude桌面后，它将自动连接到您指定的MCP服务器。默认情况下，它会在localhost:5001上查找服务器。

测试

要验证您的MCP服务器是否正常工作，可以运行以下命令：

curl -X POST http://localhost:5001 -H "Content-Type: application/json" -d '{"jsonrpc": "2.0", "method": "tools/list"}'

如果一切正常，您应该会看到类似以下的响应：

{
  "jsonrpc": "2.0",
  "result": ["get-time"],
  "id": "some-id"
}

近期修复

通知处理

服务器已更新以正确处理Claude桌面发送的notifications/initialized消息。此消息由客户端发送，以确认接收了server/initialized通知。

所做的更改：

• 添加了对notifications/initialized消息的支持
• 服务器现在正确处理此通知而不产生错误

JSON解析错误

服务器已更新以修复在Claude桌面中出现的JSON解析错误。问题是由于服务器将日志消息输出到标准输出，与JSON响应混在一起，导致JSON解析器困惑。

所做的更改：

• 禁用所有日志记录以避免干扰JSON输出
• 只有干净的JSON响应现在发送到标准输出
• 移除了重复的启动消息
• 在每个JSON响应后添加换行符以提高解析效果

Mix.env()错误修复

服务器已更新以修复运行时出现的UndefinedFunctionError: function Mix.env/0 is undefined错误。此问题是因为在escript中没有可用的Mix模块。

所做的更改：

• 用编译时常量替换运行时的Mix.env()调用
• 服务器现在正确确定是否处于测试模式，而无需依赖于Mix

故障排除

如果您遇到与Party Time MCP服务器相关的问题，请参考以下常见问题和解决方案：

UndefinedFunctionError: function Mix.env/0 is undefined

如果看到类似错误提示，则表示可执行文件构建有误。此错误是因为在escript中没有可用的Mix模块。

解决方法：

mix escript.build

权限问题

如果尝试运行可执行文件时出现权限被拒绝的错误，请赋予其执行权限：

chmod +x ./party_time_mcp

配置文件问题

如果服务器找不到或无法读取配置文件，请检查文件是否存在且具有正确的权限。

JSON 错误

如果您看到JSON解析错误，请确保输入到服务器的消息是有效的JSON-RPC 2.0格式。服务器期望消息格式如下：

{
  "jsonrpc": "2.0",
  "id": "some-id",
  "method": "method-name",
  "params": {}
}

对于不需要响应的通知（无回复的消息），应省略id字段：

{
  "jsonrpc": "2.0",
  "method": "notification-name"
}