mcpField
M
my-mcp-server

my-mcp-server

本地服务
github.com/hyen43开发工具080 周前更新
代码仓库

关于 my-mcp-server

这是一个基于 mcp-framework 构建的 MCP 服务入门项目，适合学习和扩展服务工具。项目提供示例工具、通过 CLI 生成工具的方式，以及构建和配置 Claude Desktop 的说明。

主要功能

  1. 01基于 mcp-framework 构建
  2. 02示例 MCP 工具
  3. 03通过 CLI 生成工具
  4. 04使用 npm 构建和发布
  5. 05Claude Desktop 配置说明

适用场景

  1. 01了解 MCP 服务的项目结构
  2. 02为服务项目添加工具
  3. 03在本地构建和测试服务
  4. 04发布服务以供 Claude Desktop 使用

MCP 相关

实现了带有项目自定义工具的 MCP 服务。README 说明了如何在本地或发布后将其添加到 Claude Desktop。

配置

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

暂未收录安装方式

我们还没有获取到这个服务的安装包或远程地址，请按项目 README 中的说明安装。

代码仓库

工具

还没有获取到工具列表

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

详细介绍

my-mcp-server

使用 mcp-framework 构建的 Model Context Protocol（MCP）服务。

快速开始

# Install dependencies
npm install

# Build the project
npm run build

项目结构

my-mcp-server/
├── src/
│   ├── tools/        # MCP Tools
│   │   └── ExampleTool.ts
│   └── index.ts      # Server entry point
├── package.json
└── tsconfig.json

添加组件

项目在 src/tools/ExampleTool.ts 中附带了一个示例工具。你可以使用 CLI 添加更多工具：

# Add a new tool
mcp add tool my-tool

# Example tools you might create:
mcp add tool data-processor
mcp add tool api-client
mcp add tool file-handler

工具开发

示例工具结构：

import { MCPTool } from "mcp-framework";
import { z } from "zod";

interface MyToolInput {
  message: string;
}

class MyTool extends MCPTool<MyToolInput> {
  name = "my_tool";
  description = "Describes what your tool does";

  schema = {
    message: {
      type: z.string(),
      description: "Description of this input parameter",
    },
  };

  async execute(input: MyToolInput) {
    // Your tool logic here
    return `Processed: ${input.message}`;
  }
}

export default MyTool;

发布到 npm

  1. 更新你的 package.json：

    • 确保 name 唯一，并符合 npm 命名规范
    • 设置合适的 version
    • 添加 description、author、license 等信息
    • 检查 bin 是否指向正确的入口文件

  2. 在本地构建并测试：

    npm run build
npm link
my-mcp-server  # Test your CLI locally

  3. 登录 npm（如有需要，请先创建账户）：

    npm login

  4. 发布你的软件包：

    npm publish

发布后，用户可以将其添加到 Claude 桌面客户端（见下文），或使用 npx 运行


## Using with Claude Desktop

### Local Development

Add this configuration to your Claude Desktop config file:

**MacOS**: `~/Library/Application Support/Claude/claude_desktop_config.json`
**Windows**: `%APPDATA%/Claude/claude_desktop_config.json`

```json
{
  "mcpServers": {
    "my-mcp-server": {
      "command": "node",
      "args":["/absolute/path/to/my-mcp-server/dist/index.js"]
    }
  }
}
发布后

将以下配置添加到你的 Claude Desktop 配置文件中：

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

{
  "mcpServers": {
    "my-mcp-server": {
      "command": "npx",
      "args": ["my-mcp-server"]
    }
  }
}

构建和测试

  1. 修改你的工具
  2. 运行 npm run build 进行编译
  3. 服务将在启动时自动加载你的工具

了解更多

评论

支持 Markdown

第一次接触 MCP？

从协议是什么，到在客户端里装上第一个服务，这几条回答覆盖了大多数入门问题。

一个开放协议，规定了 AI 应用如何以统一方式连接外部工具与数据源。客户端负责与模型对话，MCP 服务负责提供工具、资源和提示模板，两者通过标准消息通信，同一个服务可以被不同客户端复用。