Firestore Todo List MCP Server

Firestore Todo List MCP服务器

将任何MCP客户端（如Claude、Open WebUI和其他客户端）连接到此MCP服务器，以一种有主见的方式通过AI聊天管理待办事项。

你可以简单地告诉模型 create_todo, list_todos, update_todo“complete_todo”和 delete_todo

您还可以设置自定义系统提示以获得自定义答案。

与Claude、OpenAI和Deepseek模型（付费版本）配合得很好。Ollama的本地模型也有效，但有局限性。

数据存储在Firebase Firestore上，因为它“免费”供个人使用，易于运行和设置。

这是我为学习目的而创建的一个实验项目。

请随意尝试。

入门指南

在Claude（和其他人）上使用Firestore Todo MCP服务器

编辑 claude_desktop_config.json 或者LLM客户端的mcp配置文件

{
    "mcpServers": {
        "firestoreTodoMcp": {
            "command": "npx",
            "args": [
                "firestore-todo-mcp"
            ],
            "env": {
                "FIREBASE_SERVICE_ACCOUNT": "base64(serviceAccount.json)",
                "FIREBASE_PROJECT_ID": "your-firebase-project-id",
                "FIRESTORE_COLLECTION": "test_collection"
            },
            "type": "stdio"
        }
    }
}

别忘了在Firebase上设置项目，并从项目的配置中获取Firebase serviceAccount。

在将值传递给上面的json时，文件内容必须进行“base64”编码。

发展模式

1.克隆仓库

git clone https://github.com/gtoshinakano/firebase-todo-mcp.git
cd firebase-todo-mcp

2.运行Firestore模拟器

安装firebase工具cli，进行firebase登录，安装模拟器并运行

firebase emulators:start --only firestore --project local-todo-dev

3.检验员测试

检查所有工具是否正常工作，测试输入参数、输出参数

npx @modelcontextprotocol/inspector \
    -e FIRESTORE_EMULATOR_HOST=localhost:3333 \
    -e FIREBASE_PROJECT_ID=local-todo-dev \
    -e FIRESTORE_COLLECTION=test_collection \
    tsx bin/index.ts

4.（可选）在本地构建和配置Claude mcp配置

{
    "mcpServers": {
    "firestore-todo": {
        "command": "node",
        "args": ["/absolute/path/to/dist/bin/index.js"],
        "env": {
        "FIRESTORE_EMULATOR_HOST": "localhost:3333",
        "FIREBASE_PROJECT_ID": "local-todo-dev",
        "FIRESTORE_COLLECTION": "test_collection"
        }
    }
    }
}

5.使用示例中的系统提示创建项目

从路径中复制系统提示的内容 example/ complete：更有效，但代币昂贵 short：用于保存令牌的较短版本。工作正常，但不太准确

6.和你的新任务管理器玩得开心；)

尝试像这样聊天： Add the task XYZ. Due date tomorrow.

你可以更具体地说明情况： I forgot to talk to John regarding XYZ on Friday and I need this ASAP

或者，你可以宽泛一些，Claude会试图帮助你将大任务分解为小任务（与Olama模型不太兼容：/）： I need to create my XYZ Vague Project