Bloom Pinboard MCP服务器
一个模型上下文协议（MCP）服务器，将Claude连接到Pinboard，为Bloom网络实现人工智能辅助书签管理和集体知识发现。
布鲁姆标签公约
bloom 是一个信号标签，意味着： *“我希望网络中的其他人能够看到这个资源。”*
将其与位置标签配对，以帮助人们找到当地资源：
bloom+houstonbloom+austinbloom+detroitbloom+global（针对非特定位置的资源）
这创建了一个分散的、联合的知识层。任何人都可以通过标记书签来参与 bloom不需要中央权威，只需要一个共同的惯例。
这有什么作用
此MCP服务器允许Claude：
- 搜索并分析您的Pinboard书签
- 发现其他人的标签
bloom正在节省 - 基于共同兴趣在社区成员之间寻找联系
- 使用智能标记保存新书签
- 追踪加入bloom网络的新成员
先决条件
- Python 3.10+ 已安装在您的计算机上
- 克劳德桌面版 应用程序（不是网络版本）
- Pinboard帐户 具有API访问权限
安装
1.克隆此存储库
git clone https://github.com/YOUR-USERNAME/bloom-pinboard-mcp.git
cd bloom-pinboard-mcp2.安装Python依赖项
pip install httpx mcp3.获取您的Pinboard API代币
- 登录Pinboard
- 首选https://pinboard.in/settings/password
- 复制您的API令牌（看起来像：
username:ABC123DEF456...)
4.找到你的Python路径
窗户：
where pythonMac/Linux：
which python3复制显示的完整路径。
5.配置克劳德桌面
Claude Desktop需要一个配置文件来了解MCP服务器。
配置文件位置：
- 窗户：
%APPDATA%\Claude\claude_desktop_config.json - 雨衣：
~/Library/Application Support/Claude/claude_desktop_config.json
使用以下内容创建或编辑此文件（替换占位符）：
{
"mcpServers": {
"pinboard": {
"command": "C:\\Path\\To\\Your\\python.exe",
"args": [
"C:\\Path\\To\\Your\\bloom-pinboard-mcp\\server.py"
],
"env": {
"PINBOARD_API_TOKEN": "your-username:YOUR_API_TOKEN_HERE"
}
}
}
}重要提示：
- 使用双反睫毛(
\\)在Windows上 - 使用Python和server.py的完整绝对路径
- 保持您的API令牌私有-永远不要将其提交给git！
6.重新启动克劳德桌面
完全退出Claude Desktop（不要只是关闭窗口——在Mac上使用Cmd+Q或右键单击Windows上的系统托盘图标），然后重新打开它。
验证它是否正常工作
在Claude Desktop中，尝试询问：
- “显示我的Pinboard标签”
- “在我的书签中搜索休斯顿”
- “查找带有bloom标签的互助资源”
如果克劳德能用你的Pinboard数据回答这些问题，那么你就准备好了！
可用工具
个人书签
| 工具 | 说明 |
|---|---|
search_my_bookmarks | 搜索您的个人Pinboard收藏 |
get_my_tags | 列出所有带有计数的标签 |
save_bookmark | 保存带有标签的新书签 |
suggest_tags | 获取URL的标签建议 |
Bloom集体发现
| 工具 | 说明 |
|---|---|
search_collective | 在网络中搜索带有bloom标签的书签 |
get_recent | 获取最近的花朵书签 |
get_collective_overview | 一次通话中集体的完整快照 |
who_knows_about | 按主题查找贡献者 |
find_connections | 查找成员之间的兴趣重叠 |
get_network_map | 生成关系图 |
用户发现
| 工具 | 说明 |
|---|---|
get_user_profile | 任何Pinboard用户的完整个人资料 |
search_user_bookmarks | 搜索特定用户的公共书签 |
find_common_ground | 比较两个用户的共同兴趣 |
who_else_saved | 检查还有谁保存了URL |
会员追踪
| 工具 | 说明 |
|---|---|
discover_new_members | 使用bloom标签查找新的贡献者 |
list_known_members | 列出所有跟踪的布隆网络成员 |
reset_known_members | 清除已知成员列表 |
公用事业
| 工具 | 说明 |
|---|---|
get_feed_url | 为任何用户或标签生成RSS/JSON提要URL |
clear_cache | 清除内存缓存 |
search_public_pinboard | 搜索所有公共Pinboard书签 |
根据您的位置进行定制
服务器配置了 COLLECTIVE_TAG 变量in server.py。您可以更改此设置以匹配您当地的布鲁姆章节或搜索 bloom 大体上：
COLLECTIVE_TAG = "bloom" # Find all bloom-tagged resources globally这些工具将找到任何使用bloom约定的人，您可以在查询中按位置进行过滤。
生成自己的查看器
查看器示例：https://claude.ai/public/artifacts/c5a8be0f-f34d-4749-809f-432fe4995613
想要为您的城市或网络定制版本吗？问克劳德：
提示： “连接到Pinboard MCP并创建Bloom Network目录工件。获取所有标记有Bloom和\[您的城市\]的书签。包括：
生成式AI搜索，将用户意图与资源相匹配 主题标签过滤 让人们看到如何做出贡献的一种方式 干净、无障碍的设计
从我的Pinboard帐户中提取真实数据并将其嵌入工件中。"
或者对于更简单的静态版本：
“查询我的Pinboard中所有标记为bloom和\[你的城市\]的书签，然后使用这些资源创建一个可搜索的目录工件。”
故障排除
“无法识别python.exe”
你的Python路径是错误的。跑 where python （Windows）或 which python3 （Mac/Linux）并使用该确切路径。
服务器未在Claude中显示
- 检查JSON语法（缺少逗号、引号等）
- 确保路径是绝对的，而不是相对的
- 完全退出并重新启动Claude Desktop
“未找到书签”
- 检查您的API令牌是否正确
- 尝试
clear_cache强制执行新的API调用
检查日志
Claude Desktop将MCP错误记录到：
- 窗户：
%APPDATA%\Claude\logs\mcp-server-pinboard.log - 雨衣：
~/Library/Logs/Claude/mcp-server-pinboard.log
安全说明
- 永远不要将API令牌提交给git --使用示例配置作为模板
- 您的令牌仅存储在您的本地Claude Desktop配置中
- 服务器代表您对Pinboard的API进行读/写调用
关于Bloom Network
布鲁姆网络 是一场在全球范围内建立再生社区的草根运动。
这 bloom Pinboard上的标签是一个共享知识层，组织者、活动家和社区建设者可以在没有任何中央平台的情况下相互提供资源。标记某物 bloom 并且它变得可发现。添加您的城市，即可在本地找到。
这是集体智能的基础设施：简单、分散、不归任何人所有。
许可证
麻省理工学院
贡献
欢迎拉取请求！改进思路：
- 动态位置过滤（搜索
bloom+任何位置） - 跨位置发现（查找在多个城市标记的资源）
- 新bloom内容的摘要/通知工具
- 与其他知识共享工具集成
如果你在你的城市开始了一个绽放的篇章，让我们知道！