派对时间MCP服务器
一个简单的MCP服务器，当被问及当前时间时，它会以“It’s Party Time”作为响应。
概述
这是一个MCP服务器的简单实现，它直接从stdin读取并写入stdout。它注册了一个名为 get-time 当调用该工具时，总是以“It’s Party Time”作为响应。
服务器直接实现MCP协议，处理JSON-RPC消息并适当响应。
macOS安装说明
1.构建可执行文件
首先，构建可执行文件：
mix deps.get
mix escript.build这将创建一个名为的可执行文件 party_time_mcp 在您的项目目录中。
确保它具有执行权限：
chmod +x ./party_time_mcp2.配置克劳德桌面
- 打开您的Claude Desktop配置文件：
open -e ~/Library/Application\ Support/Claude/claude_desktop_config.json- 将以下内容添加到您的配置中（如果文件尚不存在，请使用此内容创建它）：
{
"mcpServers": {
"partytime": {
"command": "/path/to/your/party_time_mcp",
"args": []
}
}
}替换 /path/to/your/party_time_mcp 带有可执行文件的实际路径。
- 保存文件并重新启动Claude Desktop
3.测试您的服务器
- 打开克劳德桌面
- 问克劳德“现在几点了？”
- 克劳德应该检测到你的工具，并回复“是聚会时间”
故障排除
- Claude Desktop找不到该工具：确保配置中的路径正确，并且文件具有执行权限
- 权限问题：你可能需要跑步
chmod +x ./party_time_mcp如果可执行文件没有正确的权限 - 配置文件问题：确保JSON有效且格式正确
- 克劳德桌面重新启动：确保在更改配置后重新启动了Claude Desktop
- JSON解析错误：如果您看到诸如“JSON输入的意外结束”或“JSON后的意外非空白字符”之类的错误：
- 这可能是因为服务器将额外的文本与JSON响应一起输出到stdout - 确保您使用的是最新版本的服务器，该服务器通过将日志发送到stderr而不是stdout来修复此问题 - 服务器现在确保只将干净、格式正确的JSON发送到stdout - 如果您仍然看到这些错误，请查看Claude Desktop日志以了解更多详细信息
- Mix.env（）错误：如果您看到以下错误
function Mix.env/0 is undefined，这意味着可执行文件构建不正确。Mix模块在运行时在escrip中不可用。使用修复此问题的最新代码重新生成可执行文件。
调试
如果您遇到JSON错误，可以手动运行服务器以查看其输出：
./party_time_mcp然后在另一个终端中，您可以向它发送测试JSON-RPC消息：
echo '{"jsonrpc":"2.0","id":"test-1","method":"tools/list"}' | ./party_time_mcp您还可以测试其他消息类型：
# Initialize request
echo '{"jsonrpc":"2.0","id":0,"method":"initialize","params":{"protocolVersion":"2024-11-05","capabilities":{},"clientInfo":{"name":"test-client","version":"0.1.0"}}}' | ./party_time_mcp
# Notifications/initialized message
echo '{"jsonrpc":"2.0","method":"notifications/initialized"}' | ./party_time_mcp
# Tools/call request
echo '{"jsonrpc":"2.0","id":2,"method":"tools/call","params":{"name":"get-time","arguments":{}}}' | ./party_time_mcp服务器架构
Party Time MCP服务器被设计为符合机器对话协议（MCP）。它处理以下消息类型：
initialize：响应服务器功能、服务器信息和协议版本。还发送了一个server/initialized处理后的通知。notifications/initialized：处理客户端初始化通知（不需要响应）。tools/list：返回可用工具的列表。tools/call：执行指定的工具并返回结果。
服务器还包括对无效请求和未知方法的稳健错误处理。
MCP协议合规性
服务器按照中的规定实现MCP协议 模型上下文协议规范。它对所有消息都遵循JSON-RPC 2.0格式，并实现了所需的消息类型：
- 初始化：服务器响应
initialize消息及其功能，并发送server/initialized通知。 - 工具发现：服务器响应
tools/list提供可用工具列表。 - 工具执行：服务器处理
tools/call请求get-time工具。 - 错误处理：服务器对无效请求、未知方法和其他错误情况返回适当的错误响应。
测试
服务器包括全面的测试，以确保其正常运行：
- 服务器测试：测试服务器处理各种JSON-RPC消息的能力，包括：
- initialize 消息处理和响应验证 - notifications/initialized 消息处理 - tools/list 请求处理 - tools/call 请求执行“获取时间”工具
- Hermes客户测试：测试服务器与Hermes客户端的兼容性，包括：
- 处理初始化请求和服务器/初始化通知 - 处理通知/初始化消息 - 对工具/列表请求的正确响应 - 正确执行工具/调用请求
- JSON格式测试：确保所有JSON响应都按照JSON-RPC 2.0规范正确格式化。
要运行测试，请执行以下操作：
mix test重建（如果需要）
如果需要进行更改和重建：
mix deps.get
mix escript.build最近修复
通知处理
服务器已更新以正确处理 notifications/initialized 来自Claude Desktop的消息。此消息由客户端发送，以确认收到 server/initialized 通知。
所做的更改：
- 增加了对
notifications/initialized消息 - 服务器现在可以正确处理此通知，而不会产生错误
JSON解析错误
服务器已更新，以修复Claude Desktop中的JSON解析错误。问题是服务器将日志消息与JSON响应一起输出到stdout，这混淆了Claude Desktop中的JSON解析器。
所做的更改：
- 禁用所有日志记录以避免干扰JSON输出
- 现在只有干净的JSON响应被发送到stdout
- 删除了重复的启动消息
- 在每个JSON响应后添加换行符，以便更好地解析
Mix.env（）错误修复
服务器已更新以修复 Mix.env() 以escript运行时发生的错误。问题是Mix模块在运行时在escrip中不可用。
所做的更改：
- 替换运行时间
Mix.env()具有编译时模块属性的调用 - 服务器现在可以正确地确定它是否在测试模式下运行，而无需在运行时依赖Mix
故障排除
如果您遇到Party Time MCP服务器的问题，以下是一些常见问题和解决方案：
Mix.env() 错误
如果你看到一个错误，比如 UndefinedFunctionError: function Mix.env/0 is undefined，这意味着可执行文件构建不正确。Mix模块在运行时在escrip中不可用。使用最新代码重建可执行文件：
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"
}