Talebook MCP Server

Talebook MCP服务器

一个使用FastAPI构建的简单模型上下文协议（MCP）服务器，提供与书籍相关的工具。

特性

• get_books_count：返回收藏中书籍的当前计数（默认为1）
• 使用FastAPI为MCP和HTTP接口构建
• 支持stdio传输（用于MCP客户端）和HTTP端点

安装

1. 安装依赖项：

pip install -r requirements.txt

用法

作为MCP服务器运行（stdio传输）

python src/server.py

作为FastAPI HTTP服务器运行

python src/server.py --fastapi

HTTP服务器将在 http://localhost:8000

可用端点（HTTP模式）

• GET / -健康检查
• GET /tools -列出可用工具
• POST /tools/get_books_count -清点书籍数量

可用工具（MCP模式）

• get_books_count：获取当前收藏的书籍数量

- 输入：无需参数 - 输出：包含图书计数的文本内容

MCP配置

要将此服务器与MCP客户端一起使用，请在MCP配置中添加以下内容：

{
  "mcpServers": {
    "talebook-mcp": {
      "command": "python",
      "args": ["/path/to/talebook-mcp/src/server.py"],
      "env": {}
    }
  }
}

发展

服务器的结构易于扩展。要添加新工具，请执行以下操作：

1. 将工具定义添加到 list_tools() 函数
2. 将工具处理程序添加到 call_tool() 函数
3. 执行工具功能
4. 为新工具添加HTTP端点（可选）

工具使用示例

使用MCP客户端时，您可以调用 get_books_count 工具：

{
  "method": "tools/call",
  "params": {
    "name": "get_books_count",
    "arguments": {}
  }
}

服务器将响应：

{
  "content": [
    {
      "type": "text",
      "text": "Current books count: 1"
    }
  ]
}