巨魔空间mcp
MCP服务器 Trollspace API --公开了47个类型安全的工具，用于管理代码片段、金块、待办事项、想法、工具、repo、旅行、订阅等。
设置
先决条件
- Node.js>=18
- Trollspace API密钥
安装和构建
npm install
npm run build配置
将API密钥设置为环境变量：
export TROLLSPACE_API_KEY="troll_usr_your_key_here"使用Claude Desktop
将此添加到您的Claude Desktop配置中(~/Library/Application Support/Claude/claude_desktop_config.json):
{
"mcpServers": {
"trollspace": {
"command": "node",
"args": ["/path/to/troll-mcp/dist/index.js"],
"env": {
"TROLLSPACE_API_KEY": "troll_usr_your_key_here"
}
}
}
}使用Claude代码
添加到您的Claude Code MCP设置中：
claude mcp add trollspace -- node /path/to/troll-mcp/dist/index.js在您的环境中设置API密钥或通过 env 配置。
工具
代码片段
代码片段和快速参考。
| 工具 | 说明 |
|---|---|
list_snippets | 列出所有代码段 |
get_snippet | 按ID获取代码片段 |
create_snippet | 创建新代码段（名称、描述、代码、语言、标签） |
update_snippet | 更新现有代码段 |
delete_snippet | 删除代码段 |
金块
知识笔记和见解。
| 工具 | 说明 |
|---|---|
list_nuggets | 列出所有金块 |
get_nugget | 通过ID获取金块 |
create_nugget | 创建新金块（名称、描述、内容） |
update_nugget | 更新现有金块 |
delete_nugget | 删除金块 |
全部
任务管理列表。
| 工具 | 说明 |
|---|---|
list_todos | 列出所有待办事项列表 |
get_todo | 按ID获取待办事项列表 |
create_todo | 创建一个新的待办事项列表（名称、描述、内容） |
update_todo | 更新现有待办事项列表 |
delete_todo | 删除待办事项列表 |
想法
项目和内容创意。
| 工具 | 说明 |
|---|---|
list_ideas | 列出所有想法 |
get_idea | 通过ID获取想法 |
create_idea | 创建新想法（名称、内容） |
update_idea | 更新现有想法 |
delete_idea | 删除一个想法 |
工具
软件工具和资源目录。
| 工具 | 说明 |
|---|---|
list_tools | 列出所有软件工具 |
get_tool | 按ID获取工具 |
create_tool | 创建新的工具条目（名称、url、类别、描述、评级） |
update_tool | 更新现有工具条目 |
delete_tool | 删除工具条目 |
回购协议
Git仓库和项目。
| 工具 | 说明 |
|---|---|
list_repos | 列出所有存储库 |
get_repo | 按ID获取回购 |
create_repo | 创建新的仓库条目（标题、摘要、description_md、repo_url、source_type） |
update_repo | 更新现有的回购条目 |
delete_repo | 删除回购条目 |
旅行
旅行地点和体验。
| 工具 | 说明 |
|---|---|
list_travel | 列出旅行地点（按状态筛选，location_type） |
get_travel | 通过ID获取旅行地点 |
create_travel | 添加旅行地点（location_id、location_type、状态、日期、备注） |
update_travel | 更新旅行地点 |
delete_travel | 删除旅行地点 |
国家和城市
只读参考数据，用于旅行工具。
| 工具 | 说明 |
|---|---|
list_countries | 列出国家（按名称搜索，按大陆筛选） |
get_country | 通过ID获取国家 |
list_cities | 列出城市（按名称搜索，按country_id筛选） |
get_city | 通过ID获取城市 |
订阅
定期订阅管理。
| 工具 | 说明 |
|---|---|
list_subscriptions | 列出订阅（按状态、类别、usage_type、billing_cycle筛选） |
get_subscription | 按ID获取订阅 |
create_subscription | 创建订阅（名称、金额、货币、billing_cycle、usage_type） |
update_subscription | 更新订阅 |
delete_subscription | 删除订阅（保留付款历史记录） |
mark_subscription_paid | 记录付款并提前下一个账单日期 |
backfill_subscription | 生成过去期间的历史付款记录 |
list_subscription_payments | 列出特定订阅的付款 |
订阅付款
所有订阅的付款记录。
| 工具 | 说明 |
|---|---|
list_all_payments | 列出所有付款（按订阅、状态、usage_type、来源、日期范围筛选） |
get_payment | 通过ID获得付款 |
create_payment | 创建付款记录 |
update_payment | 更新付款记录 |
delete_payment | 删除付款记录 |
代理
| 工具 | 说明 |
|---|---|
agent_query | 向Trollspace代理发送自然语言请求 |
发展
重新生成API类型
如果OpenAPI规范发生变化，请重新生成TypeScript类型：
npm run generate-types项目结构
src/
client.ts # Type-safe API client (openapi-fetch + generated types)
index.ts # MCP server entry point with all tool definitions
types/api.d.ts # Auto-generated OpenAPI types (do not edit)许可证
国际学生委员会