demo-mcp-server MCP Server

Name: demo-mcp-server MCP Server
Author: xu1211

本地服务

github.com/xu1211开发工具082 周前更新

代码仓库

关于 demo-mcp-server MCP Server

这是一个用于项目管理的 TypeScript MCP 服务示例，面向需要创建或打开本地项目的 AI 客户端。它通过资源提供项目数据，并以工具支持项目操作。

主要功能

01通过 project:// URI 浏览项目
02读取项目名称、路径和元数据
03创建文本项目
04以编程方式打开项目

适用场景

01从 AI 客户端查看可用项目
02使用标题和内容创建项目
03让 AI 客户端打开项目

MCP 相关

该服务向 MCP 客户端提供项目资源，以及 create_project 和 open_project 工具。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "demo-mcp-server-xu1211": {
      "command": "npx",
      "args": [
        "-y",
        "@modelcontextprotocol/inspector"
      ]
    }
  }
}

启动命令npx -y @modelcontextprotocol/inspector

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@modelcontextprotocol/inspectorstdio

工具

还没有获取到工具列表

本地服务需要在你的电脑上运行后才能读取工具，维护者暂未提供工具列表。

详细介绍

demo-mcp-server MCP 服务

一个模型上下文协议服务

一个基于 TypeScript 的 MCP 服务，通过项目管理系统演示核心概念。主要组件：

资源：通过 URI 和分层路径查询项目工具：以编程方式创建和打开项目

目标：告诉 AI 打开项目，AI 就会调用 MCP 服务打开项目并在本地运行

功能

资源

通过 project:// URI 列出和访问项目
每个项目都有项目名称、路径和元数据
使用纯文本 MIME 类型，便于访问内容

工具

create_project - 创建新的文本项目
- 将标题和内容作为必需参数
- 将项目存储在服务状态中
open_project - 打开项目

Alt text

开发

安装依赖项：

npm install

构建服务：

npm run build

在开发过程中启用自动重建：

npm run watch

调试

由于 MCP 服务通过 stdio 通信，调试可能颇具挑战。我们建议使用 MCP Inspector，它作为包脚本提供：

npx @modelcontextprotocol/inspector node .../demo-mcp-server/build/index.js

Inspector 会提供一个 URL，供你在浏览器中访问调试工具。

安装

要与 Claude Desktop 配合使用，请添加服务配置：

MacOS：~/Library/Application Support/Claude/claude_desktop_config.json Windows：%APPDATA%/Claude/claude_desktop_config.json

{
    "demo-mcp-service": {
      "command": "/usr/local/bin/node",
      "args": [
        ".../demo-mcp-server/build/index.js"
      ],
      "disabled": false,
      "autoApprove": []
    }
}

支持 Markdown

登录后评论