项目简介
这是一个基于Model Context Protocol (MCP) 实现的服务器,旨在通过标准的MCP接口,为大型语言模型 (LLM) 客户端提供访问日本技术社区平台 Connpass 用户信息的服务。它可以获取用户的基本统计、参加的活动、发表的活动以及所属的群组等数据。
主要功能点
- 获取Connpass用户基本统计信息: 根据提供的Connpass用户昵称,获取用户的总参加活动数、管理活动数、发表活动数、以及书签活动数。
- 获取Connpass用户所属群组列表: 根据提供的Connpass用户昵称,获取该用户加入或管理的群组的详细信息列表。
- 获取Connpass用户参加的活动列表: 根据提供的Connpass用户昵称,获取该用户所有参加过的活动的详细信息列表。
- 获取Connpass用户发表的活动列表: 根据提供的Connpass用户昵称,获取该用户作为 발표者 (presenter) 参与的所有活动的详细信息列表。
安装步骤
- 获取Connpass API密钥: 访问 connpassのAPI利用について 按照指引获取 Connpass API 密钥。
- 配置环境变量: 将项目根目录下的 '.env.example' 文件复制为 '.env' 文件,并在 '.env' 文件中填入你的 Connpass API 密钥。
cp .env.example .env # 编辑 .env 文件,设置 CONNPASS_API_KEY 的值 - 安装 Deno: 如果你的系统上还没有安装 Deno 运行时,请根据 Deno 官方文档进行安装。
- 安装依赖: 项目使用 Deno 的 'npm:' specifier 导入依赖,Deno 会自动下载。无需手动执行 npm install 或 yarn install。
服务器配置
该MCP服务器通过Stdio传输协议与MCP客户端通信。在MCP客户端(如兼容MCP的LLM应用)中配置此服务器时,你需要提供启动服务器进程的命令和参数。典型的配置结构如下(以Claude Desktop为例,但请根据你的客户端类型进行配置):
// 这是一个配置示例,实际配置请根据你的MCP客户端界面或文件格式填写 "你的服务器标识名称": { // 在客户端中识别这个服务器的名称 "command": "...", // 启动服务器的可执行命令,例如 "deno" 或 "wsl.exe" "args": [ // 传递给 command 的参数列表 "...", // 例如 Deno 的可执行路径 (如 /home/user/.deno/bin/deno) "--allow-net=connpass.com", // 允许网络访问 Connpass API "--env-file=...", // 指定包含 CONNPASS_API_KEY 的 .env 文件路径 "--allow-read", // 允许读取文件 (用于读取 .env 文件) "--allow-env", // 允许访问环境变量 (用于读取 CONNPASS_API_KEY) "...", // 服务器主脚本的完整路径,例如 /path/to/your/repo/connpass-user-mcp-server.ts // 其他可能需要的 Deno 启动参数 ] }
你需要将 'command' 和 'args' 中的路径替换为你实际的 Deno 可执行文件路径、'.env' 文件路径以及 'connpass-user-mcp-server.ts' 脚本文件路径。
基本使用方法
当MCP服务器配置并运行后,兼容的LLM客户端即可通过自然语言交互来调用其功能。你可以尝试向LLM提出以下类型的请求:
- "请告诉我用户 yamanoku 和 okuto_oyama 在 Connpass 上的用户统计信息。" (这会触发 'get_connpass_user_list' 工具)
- "yamanoku 在 Connpass 上加入了哪些群组?" (这会触发 'get_connpass_user_group_list' 工具)
- "我想看看 yamanoku 参加过的 Connpass 活动列表。" (这会触发 'get_connpass_user_events' 工具)
- "列出 yamanoku 在 Connpass 上发表过的所有活动。" (这会触发 'get_connpass_user_presenter_events' 工具)
LLM将解析你的请求,识别需要使用的工具和相应的参数(例如用户昵称),然后通过MCP协议调用服务器的工具,并将返回的数据呈现给你。
信息
分类
网页与API