MCP.so
ログイン

toyMCP To-Do List Server

@izaqyos

リポジトリ

toyMCP To-Do List 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.

基本情報

カテゴリ

開発者ツール

ランタイム

node

トランスポート

stdio

公開者

izaqyos

設定

以下の設定を使って、このサーバーを MCP 対応クライアントに追加してください。

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

ツール

ツールは検出されませんでした

ツールは 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

FAQ from toyMCP To-Do List Server

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.

コメント

「開発者ツール」の他のコンテンツ

sentry-mcp

getsentry

An MCP server for interacting with Sentry via LLMs.

754

DevDocs by CyberAGI 🚀

cyberagiinc

Completely free, private, UI based Tech Documentation MCP server. Designed for coders and software developers in mind. Easily integrate into Cursor, Windsurf, Cline, Roo Code, Claude Desktop App

2.1K

MCP-Scan: An MCP Security Scanner

invariantlabs-ai

Security scanner for AI agents, MCP servers and agent skills.

2.8K

Huoshan Test

volcengine

2.4K

mcp-excalidraw

yctimlin

MCP server and Claude Code skill for Excalidraw — programmatic canvas toolkit to create, edit, and export diagrams via AI agents with real-time canvas sync.

2.1K