🚀 边缘注释 MCP 服务器
边缘注释 MCP 服务器借助 Marginalia Search 来实现搜索功能，该搜索引擎专注于挖掘网络上的非商业内容和隐藏瑰宝。此服务器基于模型上下文协议 (MCP) 构建，为用户带来独特的搜索体验。
🚀 快速开始
边缘注释 MCP 服务器是一个强大的工具，可利用 Marginalia 搜索 API 搜索互联网。以下是使用它的基本步骤。
✨ 主要特性
- 强大搜索：使用 Marginalia 搜索 API 搜索互联网，获取非商业内容和隐藏瑰宝。
- 灵活配置：可配置搜索参数，包括索引和结果数量，满足多样化需求。
- 稳定可靠：具备速率限制保护和有用的错误消息，保障服务稳定运行。
- 无缝集成：使用 MCP SDK 构建，与其他系统集成无缝。
📦 安装指南
npm install
npm run build
📚 详细文档
配置说明
服务器可通过环境变量进行配置：
MARGINALIA_API_KEY：您的 Marginalia 搜索 API 密钥（可选，默认为公共访问）。 如需获取专用 API 密钥，请联系：kontakt@marginalia.nu
使用方法
服务器提供以下 MCP 工具：
搜索
使用 Marginalia 搜索的以下参数搜索互联网：
query（必需）：搜索查询字符串。index（可选）：搜索索引编号（对应于主 GUI 中的下拉菜单）。count（可选）：要返回的结果数量（1 - 100，默认：10）。
通过 MCP 的示例使用：
const result = await mcp.useTool("marginalia", "search", {
query: "interesting non-commercial websites",
count: 5
});
响应格式
搜索结果以以下格式返回：
{
"query": "your search query",
"license": "license information",
"results": [
{
"url": "result url",
"title": "page title",
"description": "page description"
}
// ... 更多结果
]
}
错误处理
服务器包含 robust 的错误处理功能，包括：
- 速率限制（503 响应）
- 无效请求
- 网络错误
- API 特定错误
添加文本到语音支持
要启用使用 say MCP 服务器的文本到语音功能，请添加以下配置：
对于 Cline（VSCode 扩展）
添加到 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json：
{
"mcpServers": {
"say": {
"command": "node",
"args": ["/Users/barton/worlds/servers/src/say-mcp-server/build/index.js"]
}
}
}
对于 Claude Desktop
添加到 ~/Library/Application Support/Claude/claude_desktop_config.json：
{
"mcpServers": {
"say": {
"command": "node",
"args": ["/Users/barton/worlds/servers/src/say-mcp-server/build/index.js"]
}
}
}
Say MCP 服务器提供文本到语音功能，支持多种声音和语言。可用工具：
speak：使用指定声音和速率阅读文本。list_voices：列出所有可用的文本到语音声音。
📄 许可证
本项目采用 MIT License，有关详细信息，请参阅 LICENSE 文件。