基本能力
产品定位
Marginalia MCP Server 是一个提供 Marginalia Search API 访问的 MCP 服务器，专注于非商业内容和互联网隐藏宝藏的搜索。
核心功能
- 使用 Marginalia Search API 进行网络搜索
- 可配置的搜索参数，包括索引和结果数量
- 速率限制保护，并提供有用的错误信息
- 使用 MCP SDK 构建，便于集成
适用场景
- 开发需要集成 Marginalia Search API 的应用
- 需要搜索非商业内容和互联网隐藏宝藏的场景
工具列表
- search: 使用 Marginalia Search 进行网络搜索，支持查询字符串、索引和结果数量等参数。
常见问题解答
- 如何获取 API 密钥？联系 kontakt@marginalia.nu 请求专用 API 密钥。
- 如何处理速率限制？服务器会返回 503 响应，并提供有用的错误信息。
使用教程
使用依赖
确保已安装 Node.js 和 npm。
安装教程
bash
npm install
npm run build
配置
通过环境变量配置服务器：
- MARGINALIA_API_KEY: 您的 Marginalia Search API 密钥（可选，默认为公共访问）
调试方式
使用 MCP 工具进行搜索示例：
typescript
const result = await mcp.useTool("marginalia", "search", {
query: "interesting non-commercial websites",
count: 5
});
添加文本转语音支持
对于 Cline (VSCode 扩展)
添加到 ~/Library/Application Support/Code/User/globalStorage/saoudrizwan.claude-dev/settings/cline_mcp_settings.json:
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:
json
{
"mcpServers": {
"say": {
"command": "node",
"args": ["/Users/barton/worlds/servers/src/say-mcp-server/build/index.js"]
}
}
}
文本转语音工具
- speak: 使用指定语音和速率朗读文本
- list_voices: 列出所有可用的文本转语音语音
