toyMCP To-Do List Server MCP Server

@izaqyos

代码仓库

基本信息

分类

开发工具

传输方式

stdio

作者

izaqyos

关于 toyMCP To-Do List Server MCP Server

This is a simple example server implementing a To-Do list CRUD API using the Model Context Protocol (MCP) concepts, specifically using JSON-RPC 2.0 over HTTP. It uses Node.js, Express, and PostgreSQL (via Docker) for persistence.

toyMCP To-Do List Server MCP Server 配置

使用下面的配置,将此服务器添加到你的 MCP 客户端。

{
  "mcpServers": {
    "toyMCP": {
      "command": "docker",
      "args": [
        "compose",
        "up",
        "-d",
        "db"
      ]
    }
  }
}

toyMCP To-Do List Server MCP Server 工具

工具列表暂未提供

当前收录暂时没有可展示的工具列表，不代表服务没有工具。请查阅项目文档了解支持的能力。

工具是从 README 中自动提取的。维护者可以在 ## Tools 标题下列出工具,即可填充这部分内容。

概览

What is toyMCP To-Do List Server?

toyMCP To-Do List Server is a simple example server that implements a To-Do list CRUD API using the Model Context Protocol (MCP) concepts, specifically JSON-RPC 2.0 over HTTP. It uses Node.js, Express, and PostgreSQL (via Docker) for persistence, and includes an AI-powered agent framework for natural language interaction.

How to use toyMCP To-Do List Server?

Set up prerequisites: Node.js, npm, Docker, and Docker Compose. Clone the repository, run npm install, start PostgreSQL with docker compose up -d db, then start the server with npm start. The JSON-RPC endpoint is at http://localhost:3000/rpc. Authenticate by logging in at /auth/login with username and password to obtain a JWT token, then include it as an Authorization: Bearer <token> header in subsequent requests. Use curl to call methods like todo.list, todo.add, todo.remove, or mcp.discover. For natural language management, use the agent framework in the agent-framework/ directory.

Key features of toyMCP To-Do List Server

JSON-RPC 2.0 API over HTTP
CRUD operations for todo items
JWT-based authentication
PostgreSQL persistence via Docker
Interactive Swagger UI documentation
AI-powered natural language agent framework
Unit, integration, and end-to-end tests

Use cases of toyMCP To-Do List Server

Manage a personal todo list via API calls
Integrate with AI agents using natural language
Serve as a learning example for MCP and JSON-RPC
Automated testing of CRUD operations

常见问题

What is the default port and endpoint?

The server listens on port 3000 by default (configurable via the `PORT` environment variable), and the JSON-RPC endpoint is at `/rpc`.

How do I authenticate?

Send a POST request to `/auth/login` with your username and password. Copy the token from the response, then include it as an `Authorization: Bearer <token>` header in all subsequent requests to protected endpoints.

What are the available JSON-RPC methods?

The methods are `todo.list`, `todo.add`, `todo.remove`, and `mcp.discover` (which describes the service and its available methods).

What are the dependencies?

The server requires Node.js, npm, Docker, and Docker Compose for the PostgreSQL database. The agent framework can use local Ollama or OpenAI cloud models.

How can I reset the database?

Use the `clean_start.sh` script, which stops and removes the database container, restarts it, and then starts the server fresh.

开发工具分类下的更多 MCP 服务器

GripForge

gripforgeai

The tools your AI needs to make your games. Turn prompts into production-ready game assets — animated characters with their weapons attached, seamless textures, terrain, VFX, HUDs — and playable game kits Unity, Godot, U

Cronwatch

cronwatchdev

CronWatch records every run of your scheduled jobs in your own database, and speaks up when one is missed, fails, gets stuck, runs slow or costs too much. CronWatch is free and open-source.

SSH MCP Server

hypnosis

SSH MCP server for AI agents: remote commands, file transfer, log search and server audits through OpenSSH.

Skycloak

Manage your Skycloak-hosted Keycloak: clusters, realms, apps, SSO and users, from any MCP client.