AI导哈

文档管理API服务

一个与esa.io API集成的Python实现的文档管理服务，提供用户信息获取、文章列表获取、文章详情获取、文章创建、更新和删除等功能。

  • by scnsh
  • Python
  • 本地部署
  • 1 星标
  • 更新于
在 GitHub 查看 scnsh/mcp-esa-server-python

使用说明

mcp esa服务器python

esa.io API 与…合作Model Context Protocol Server (mcp server)来修改标记元素的显示属性。Python中所述修改相应参数的值。

能做的事

现在提供了以下功能。

  • 用户信息获取（user_get_info）
  • 记事一覧取得（posts_get_list）
  • 记事详细取得（posts_get_detail）
  • 记事作成（posts_create）
  • 记事更新（posts_update）
  • 记事削除（posts_delete）

安装过程

前提条件

  • esa.io的，之API已发出标记

  • uv 使用

  • 互联网连接

  • esa.io的，之API如何提交标记

    • 你的身影esa.io 访问团队页面（例如： https://<your-team-name>.esa.io/)。
    • 单击功能区上SETTINGS单击，选择“用户设置”>“外部应用程序协作”。
    • 「Personal access tokens」单击功能区上的「Generate new token」按钮关闭对话框。
    • 标记名称（例如： mcp-server），然后选择所需的权限范围。这个MCP 服务器至少需要具有以下权限：
      • read （读取文章）
      • write （文章的制作、更新、删除）
      • read_user （获取用户信息）（此项目会自动启用，因此可能不会显示）
    • 「Save」按钮关闭对话框。
    • 请务必复制显示的标记并将其存储在安全位置。此标记仅显示一次。
    • 复制的令牌如后所述 .env 在动态输入提示中单击 ESA_TOKEN 的明细栏样式中定义的设置。

  • esa.io 那么，从签名开始提供两个月的免费试用期。利用这个期间，测试用的队伍名和API可以获取令牌。

  • 为了安全起见，请注意不要直接公开令牌。

项目初始化

uv sync

开发（本地使用方法）

参加开发的情况MCPInspector中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。

  1. 设置环境变量 .env.example 作为参考.env 想要运行服务器的目录（.env.example中所述修改相应参数的值。

    ESA_TEAM_NAME="YOUR_ESA_TEAM_NAME" # Replace with your esa.io team name (e.g., "myteam")
ESA_TOKEN="YOUR_ESA_API_TOKEN"     # Replace with your esa.io API access token

  2. 実行方法 执行下述命令后，有指示URL通过从中打开浏览器MCP Inspector中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。

    uv run mcp run main.py

MCPServer作为Cursor在编辑器中使用的方法

  1. mcp.json创建示例

项目根目录或 ~/.cursor/mcp.json 中描述的场景，使用下列步骤创建明细表，以便在概念设计中分析体量的周长。

{
  "mcpServers": {
    "mcp-esa-server": {
      "command": "uv",
      "args": [
        "--directory",
        "<プロジェクトの絶対パス>",
        "run",
        "main.py"
      ],
      "env": {
        "ESA_TEAM_NAME": "<your-team-name>",
        "ESA_TOKEN": "<your-esa-token>"
      }
    }
  }
}
  • <your-team-name> 打开 <your-esa-token> 各自的esa.io团队名称API请用令牌替换。
  • env：将环境变量 直接 进行配置。在您查看完详细信息后，单击.cursor/mcp.json 中描述的场景，使用以下步骤创建明细表，以便在概念设计中分析体量的体积。
  1. Cursor在编辑器中MCP启动服务器
  • Cursor编辑器的命令调色板UI中描述的场景，使用下列步骤创建明细表，以便在概念设计中分析体量的周长。
  • mcp.json中所述修改相应参数的值uv run main.py 将条目添加到文档注册表。
  • .env 文件和环境变量也会自动读取。
  1. AI从聊天和工具面板API打开和保存文件
  • AI聊天时 user_get_info 屋脊 posts_get_list 等的MCP在动态输入提示中单击esa.io API进行动态观察时的轴心点。
  • mcp-esa-serverを使って記事の作成をお願いします 等可以在聊天上写入。

许可证

这个项目 MIT许可证 的明细栏样式中定义的设置。

使用的外部代码/Dependencies

在本项目的一部分中MIT License中所述修改相应参数的值。

  • esa mcp服务器
    • GitHub存储库：[https://github.com/masseater/esa-mcp-server]
    • 许可证：MIT License

其他

生成元 (Generated by)

由Cursor生成（双子座-2.5-pro-exp-03-25）

相关 MCP