Demo Remote MCP Todo

MCP运维云端

提供方 ramanjk

运维云端 stdio · 本地进程 会话登录 社区 / 第三方 Cursor
查看接入方式

一个基于Python的远程MCP(Model Context Protocol)服务器,支持Todo管理功能,可通过HTTP访问并部署到Azure Container Apps。

一句话选型结论

按资料字段整理

Demo Remote MCP Todo 属于运维云端类 MCP 服务器,stdio · 本地进程,会话登录,可直接接入 Cursor,有可直接执行的安装命令。接入前先确认权限范围;涉及写入、删除或付款的操作,建议先在测试环境验证。

分类运维云端 传输方式stdio · 本地进程 鉴权会话登录 部署方式本地部署
GitHub 星标 0 仓库热度,无公开仓库时显示未标注
工具数 5 暴露给模型的工具数量
资源 / 提示词 0 / 0 资源与提示词模板数量
维护方 社区 / 第三方 核验等级 仅资料核对

工具与能力

运维云端
数量来自来源目录的标注,具体工具清单以官方文档为准
工具数量5暴露给模型可调用的工具个数
资源数量0可读取的资源条目
提示词数量0内置提示词模板数量

能力标签

支持客户端

适用场景

MCP服务器Python本地部署Todo管理HTTP服务Azure部署Python开发

安装与配置

stdio · 本地进程 会话登录
客户端在本机拉起子进程,数据不出本机
uv run hello.py

这条命令只是入口,具体启动参数请按官方文档补齐,不要直接照搬到别的服务器。

  1. 1
    准备运行环境

    stdio 服务在本地起进程,需要先装好 Python,再按安装命令拉取依赖。

  2. 2
    安装服务

    复制上面的安装命令执行;命令里带占位符的位置,换成自己的密钥或路径。

  3. 3
    写入客户端配置

    在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,让新配置生效。

  4. 4
    验证是否可用

    连接成功后客户端会列出约 5 个工具,随便调一个只读工具确认能返回结果。

典型使用场景

3 类
按分类与标签整理的常见用法,具体以官方文档为准
云资源查询

查实例、存储、账单等云上资源状态。

部署与发布

把部署、重启、回滚这类操作接进对话。

监控与告警

拉取监控指标,异常时让模型帮你判断。

选择建议

选之前先看这几条
按条目字段给出的判断,不替你决定用不用

值得选的地方

  • 资料标注 5 个工具,职责相对集中,接入后不容易误操作。
  • 有现成的安装命令,不用自己找入口,照着跑就能起服务。
  • 已适配 Cursor,换客户端不用重新研究配置。

先想清楚的地方

  • stdio 方式要求本地装好运行时(如 Node.js),换机器要重新装一遍。
  • 使用前要准备好会话登录对应的凭据,并按最小权限配置。
  • 版本更新与行为细节以官方仓库为准。

更适合

  • 需要在运维云端场景里让模型直接调用外部能力的人。
  • 已经在用 Cursor 的用户,接入路径最短。
  • 想先快速试一下、能接受在本地或自有环境跑服务的人。

不太适合

  • 完全不想在本地装环境的人。
  • 不方便管理密钥或第三方授权的人。
  • 需要厂商级 SLA 和技术支持的生产环境。

同类对比

6 个同类
同分类里挑最接近的几条,字段以各自详情页为准
MCP 服务器工具数传输方式部署方式安装命令最后核验
Demo Remote MCP Todo当前 5 stdio · 本地进程 本地部署 有 2026-05-17
lobehub 未标注 stdio · 本地进程 本地部署 有 2026-04-11
TrendRadar 未标注 stdio · 本地进程 本地部署 有 2026-04-13
Ui Tars Desktop 8a825770 未标注 stdio · 本地进程 本地部署 有 2026-05-17
ruflo 未标注 stdio · 本地进程 本地部署 有 2026-04-13
FastGPT 未标注 stdio · 本地进程 本地部署 有 2026-04-11

服务器档案

运维云端
字段来自项目仓库与公开索引,中文说明由本站标注
提供方ramanjk上游标注的维护方 ramanjk
分类运维云端本站按上游分类展示
连接方式stdio · 本地进程客户端在本机拉起子进程,数据不出本机
鉴权方式会话登录远程服务建议用最小权限凭据
维护方社区 / 第三方核验等级 仅资料核对
包名 / 运行时未标注 · Python本地安装时用到的包标识与运行时
部署类型本地部署上游给出的部署形态
最近核验2026-05-17上游最后核验时间

详细介绍

9.2 KB
来自项目仓库与上游目录的原文,未做删改

🚀 远程MCP服务器演示(Python)

本指南向您展示了如何构建 远程MCP(模型上下文协议)服务器 从头开始——从简单开始 你好,世界 并演变成一个完整的 Todo管理MCP服务器,可通过以下方式访问 超文本传输协议 并可部署到 Azure容器应用.

我们遵循 渐进式、动手型 演示现实世界MCP开发的方法。


📌 目录

  • 第1节——项目设置和基本MCP服务器
  • 第2节——实际功能:待办事项管理
  • 第3节——MCP工具和HTTP服务器
  • 第4节-部署到Azure容器应用程序
  • 结束总结
  • 资源

第1节——项目设置和基本MCP服务器

🛠️ 演示命令

1.初始化一个新的Python项目 紫外线```bash

uv init remote-mcp-demo
cd remote-mcp-demo


### 2.验证设置```bash
uv run hello.py

3.安装Python MCP SDK```bash

uv add "mcp[cli]"


______________________________________________________________________

## ▶️ 您的第一台MCP服务器

### 4.创建服务器文件```bash
mkdir src

src/dummy_server.py```python
from mcp.server.fastmcp import FastMCP

Create an MCP server using FastMCP

mcp = FastMCP("dummy-mcp-server")

@mcp.tool()
def hello_world(name: str) -> str:
"""Simple hello world tool"""
return f"Hello, {name}!"


### 5.测试MCP服务器```bash
uv run mcp dev src/dummy_server.py


第2节:构建真正的功能——Todo管理

添加真实的业务逻辑

创建文件: src/db.py

安装Pydantic进行数据验证:```bash
uv add pydantic


### `db.py` –带验证的SQLite数据库层```python
import sqlite3
import os
from typing import List, Dict, Any, Optional
from pydantic import BaseModel, Field, field_validator
import logging

# Setup logging
logging.basicConfig(level=logging.INFO)
logger = logging.getLogger("db")

class TodoSchema(BaseModel):
title: str = Field(..., min_length=1, max_length=255)
id: Optional[int] = Field(None, gt=0)

@field_validator('title')
@classmethod
def validate_title(cls, v: str) -> str:
if not v or v.strip() == '':
raise ValueError('Title cannot be empty or contain only whitespace')
return v.strip()

DB_NAME = "todos.db"

def init_db():
"""Initialize the SQLite database"""
try:
conn = sqlite3.connect(DB_NAME)
cursor = conn.cursor()
cursor.execute("""
CREATE TABLE IF NOT EXISTS todos (
id INTEGER PRIMARY KEY AUTOINCREMENT,
text TEXT NOT NULL,
completed INTEGER NOT NULL DEFAULT 0
)
""")
conn.commit()
conn.close()
logger.info(f'Database "{DB_NAME}" initialized.')
except Exception as error:
logger.error(f'Error initializing database "{DB_NAME}": {error}')

# Initialize database on import
init_db()

def add_todo(text: str) -> Dict[str, Any]:
"""Add a new todo to the database"""
logger.info(f"Adding TODO: {text}")

# Validate input
validated_input = TodoSchema(title=text)

conn = sqlite3.connect(DB_NAME)
cursor = conn.cursor()
cursor.execute("INSERT INTO todos (text) VALUES (?)", (validated_input.title,))
lastInsertRowid = cursor.lastrowid
conn.commit()
conn.close()
return {"lastInsertRowid": lastInsertRowid}

def list_todos() -> List[Dict[str, Any]]:
"""Get all todos from the database"""
logger.info("Listing all TODOs")

conn = sqlite3.connect(DB_NAME)
conn.row_factory = sqlite3.Row
cursor = conn.cursor()
cursor.execute("SELECT * FROM todos ORDER BY id")
rows = cursor.fetchall()
conn.close()
return [dict(row) for row in rows]

def complete_todo(todo_id: int) -> Dict[str, Any]:
"""Mark a todo as completed"""
logger.info(f"Completing TODO: {todo_id}")

conn = sqlite3.connect(DB_NAME)
cursor = conn.cursor()
cursor.execute("UPDATE todos SET completed = 1 WHERE id = ?", (todo_id,))
changes = cursor.rowcount
conn.commit()
conn.close()
return {"changes": changes}

def delete_todo(todo_id: int) -> Optional[Dict[str, Any]]:
"""Delete a todo from the database"""
logger.info(f"Deleting TODO: {todo_id}")

conn = sqlite3.connect(DB_NAME)
conn.row_factory = sqlite3.Row
cursor = conn.cursor()

# Get the todo before deleting
cursor.execute("SELECT * FROM todos WHERE id = ?", (todo_id,))
row = cursor.fetchone()

if row:
cursor.execute("DELETE FROM todos WHERE id = ?", (todo_id,))
conn.commit()
conn.close()
return dict(row)

conn.close()
return None

def update_todo_text(todo_id: int, text: str) -> Optional[Dict[str, Any]]:
"""Update the text of a todo"""
logger.info(f"Updating TODO {todo_id}: {text}")

# Validate input
validated_input = TodoSchema(title=text, id=todo_id)

conn = sqlite3.connect(DB_NAME)
conn.row_factory = sqlite3.Row
cursor = conn.cursor()

cursor.execute("UPDATE todos SET text = ? WHERE id = ?", (validated_input.title, todo_id))

if cursor.rowcount > 0:
cursor.execute("SELECT * FROM todos WHERE id = ?", (todo_id,))
row = cursor.fetchone()
conn.commit()
conn.close()
return dict(row) if row else None

conn.close()
return None

第3节——MCP工具和HTTP服务器

🧰 创建MCP工具

文件: `src/tools.py````python

from mcp.server.fastmcp import FastMCP
from typing import List
from db import (
add_todo,
list_todos,
complete_todo,
delete_todo,
update_todo_text,
)

Create an MCP server

mcp = FastMCP("todo-mcp-server")

@mcp.tool()
def add_todo_tool(title: str) -> List[str]:
info = add_todo(title)
return [f"Added TODO: {title} (id: {info['lastInsertRowid']})"]

@mcp.tool()
def list_todos_tool() -> List[str]:
todos = list_todos()
if not todos:
return ["No TODOs found."]
return [
f"TODO: {todo['text']} (id: {todo['id']}){' [completed]' if todo['completed'] else ''}"
for todo in todos
]

@mcp.tool()
def complete_todo_tool(id: int) -> List[str]:
info = complete_todo(id)
if info["changes"] == 0:
return [f"TODO with id {id} not found."]
return [f"TODO with id {id} marked as completed."]

@mcp.tool()
def delete_todo_tool(id: int) -> List[str]:
row = delete_todo(id)
if not row:
return [f"TODO with id {id} not found."]
return [f"Deleted TODO: {row['text']} (id: {id})"]

@mcp.tool()
def update_todo_text_tool(id: int, text: str) -> List[str]:
row = update_todo_text(id, text)
if not row:
return [f"TODO with id {id} not found."]
return [f"Updated text for todo with id {id} to \"{text}\""]


### 测试:```bash
uv run mcp dev src/tools.py

🧪 使用VS代码副本进行测试

添加到您的VS代码 settings.json:```json
"my-todo-mcp-server": {
"type": "stdio",
"command": "uv",
"args": [
"run",
"mcp",
"run",
"/path/to/your/project/src/tools.py"
]
}


______________________________________________________________________

## 🌐 转换为HTTP(远程MCP服务器)```bash
cp src/tools.py src/streamable_http_server.py

在文件底部添加:```python
if name == "main":
mcp.run(transport="streamable-http")


### 运行HTTP服务器```bash
uv run python src/streamable_http_server.py

通过检验员进行测试```bash

npx @modelcontextprotocol/inspector http://127.0.0.1:3000/mcp


______________________________________________________________________

# 第4节-部署到Azure容器应用程序

## ☁️ 将其投入生产

### 1.安装Azure Developer CLI```bash
curl -fsSL https://aka.ms/install-azd.sh | bash
curl -fsSL https://aka.ms/install-azd.sh | bash
azd version

2.登录```bash

azd auth login


### 3.供应+部署```bash
azd init
azd up

注意:确保您有infrarfolder文件、Dockerfile、azure.yaml和azure app_streaable_http_server.py。


📘 基础设施概述

这 红外线/ 文件夹包含:

  • resources.bicep → 容器应用程序、ACR、监控
  • main.bicep → 协调部署

测试部署的服务器```bash

npx @modelcontextprotocol/inspector https://mcp-container-py.blacksky-4375de5a.eastus.azurecontainerapps.io/mcp


## 🧪 将其添加到vscode中```json
"todo-remote": {
"type": "http",
"url": "https://mcp-container-py.blacksky-4375de5a.eastus.azurecontainerapps.io/mcp"

},

结束总结

✅ 我们建造了什么

  • 创建了一个基本 MCP服务器
  • 实现 5个Todo CRUD工具
  • 转换自 标准输入输出→ HTTP
  • 部署到 Azure容器应用 全球可用性

🚀 后续步骤

  • 添加更丰富的业务逻辑
  • 实现身份验证和RBAC
  • 启用速率限制/缓存
  • 添加健康检查和监测

资源

  • 演示代码: https://github.com/ramanjk/demo-remote-mcp-todo
  • MCP授权深度学习: https://github.blog/ai-and-ml/generative-ai/how-to-build-secure-and-scalable-remote-mcp-servers/
  • MCP Python SDK: https://github.com/modelcontextprotocol/python-sdk
  • MCP规范: https://spec.modelcontextprotocol.io/
  • Azure容器应用程序: https://learn.microsoft.com/en-us/azure/container-apps/
  • 微软MCP计划: https://github.com/microsoft/mcp

常见问题

8 问
答案由本站依据条目字段整理,不引用上游原文
Demo Remote MCP Todo 怎么安装?

在客户端按下面的安装命令接入:uv run hello.py。装完在客户端配置里引用同一个包或端点。

Demo Remote MCP Todo 怎么在 Cursor 里配置?

它的传输方式是stdio · 本地进程,在客户端的 MCP 配置里填好启动命令和参数,保存后完全退出客户端再打开,配置才会生效。

Demo Remote MCP Todo 收费吗?

本站不代收费用,也没有标注具体价格。是否收费取决于服务本身和背后的接口额度,正式使用前按官方说明确认。

Demo Remote MCP Todo 需要 API Key 吗?

资料标注需要会话登录认证,使用前准备好对应凭据,并按最小权限配置。

Demo Remote MCP Todo 支持哪些客户端?

资料标注支持 Cursor;其他客户端只要能配置 MCP Server,也能用同样的命令或地址接入。

Demo Remote MCP Todo 能提供哪些能力?

资料显示约 5 个工具;能力标签包括 HTTP服务、Python、Cursor。具体工具清单以官方文档为准。

Demo Remote MCP Todo 需要什么运行环境?

运行时为 Python;属于本地进程,需要在本机装好运行环境。

Demo Remote MCP Todo 是本地还是远程?

它是本地进程(stdio),由客户端在本机拉起。传输方式为stdio · 本地进程。

热门专题

按标签挑服务器
全部专题 →

服务器信息以作者仓库与官方文档为准;分类、传输方式与鉴权方式的中文说明为中文整理,最近核验 2026-05-17。