yuanqi-agent-mcp


Nameyuanqi-agent-mcp JSON
Version 0.1.7 PyPI version JSON
download
home_pageNone
Summarymcp server to invoke yuanqi agent
upload_time2025-05-06 14:41:07
maintainerNone
docs_urlNone
authorNone
requires_python>=3.10
licenseNone
keywords agent mcp yuanqi
VCS
bugtrack_url
requirements No requirements were recorded.
Travis-CI No Travis.
coveralls test coverage No coveralls.
            <div align="center">
<a href="https://yuanqi.tencent.com/" target="_blank" rel="noopener">
  <picture>
    <source media="(prefers-color-scheme: dark)" srcset="https://open-agents-web-cdn-prd.hunyuan.tencent.com/public/bf6b0f00a2e660e0e35d.png" />
    <img alt="Framelink" src="https://open-agents-web-cdn-prd.hunyuan.tencent.com/public/bf6b0f00a2e660e0e35d.png" />
  </picture>
</a>

  <h1>元器智能体 MCP 服务器</h1>
  <h3>为您的元器智能体提供 mcp 访问能力。<br/>一次性在任何智能体框架中集成。</h3>
  <a href="https://github.com/GLips/Figma-Context-MCP/blob/main/LICENSE">
    <img alt="MIT 许可证" src="https://img.shields.io/github/license/GLips/Figma-Context-MCP" />
  </a>
</div>
<br/>
<p align="center">
  <a href="https://yuanqi.tencent.com/">元器</a>官方智能体上下文协议(MCP)服务器,支持与强大的元器智能体交互。允许MCP客户端如<a href="https://www.anthropic.com/claude">Claude Desktop</a>、<a href="https://www.cursor.so">Cursor</a>、<a href="https://codeium.com/windsurf">Windsurf</a>、<a href="https://github.com/openai/openai-agents-python">OpenAI Agents</a>等进行集成。
</p>

## 快速开始使用 MCP 客户端

1. 从[元器智能体平台](https://yuanqi.tencent.com/)获取你开发的智能体的 API 密钥。
2. 安装`uv`(Python包管理器),使用`curl -LsSf https://astral.sh/uv/install.sh | sh`安装或查看`uv` [仓库](https://github.com/astral-sh/uv)获取其他安装方法。
3. **重要提示: 每个元器智能体的ID和密钥都不相同**,两者需要匹配,否则会有 `token验证失败` 的错误

### Claude Desktop

前往`Claude > Settings > Developer > Edit Config > claude_desktop_config.json`包含以下内容:

```
{
  "mcpServers": {
    "YuanQiAgent": {
      "command": "uvx",
      "args": [
        "yuanqi-agent-mcp"
      ],
      "env": {
        "TOOL_NAME": "填写你提供调用的元器智能体名称",
        "TOOL_DESC": "填写你提供调用的元器智能体描述,方便AI工具",
        "ASSISTANT_ID": "填写你调用的元器智能体ID",
        "API_KEY": "填写你调用的元器智能体Token"
      }
    }
  }
}
```

⚠️ 注意:API_KEY需要与ASSISTANT_ID匹配。如果出现“token验证失败”错误,请检查您的API_KEY和ASSISTANT_ID。
如果你使用Windows,你需要在Claude Desktop中启用"开发者模式"才能使用MCP服务器。点击左上角汉堡菜单中的"Help",然后选择"Enable Developer Mode"。

### Cursor

前往`Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server`添加上述配置。


## Transport

我们仅支持 stdio 传输方式

            

Raw data

            {
    "_id": null,
    "home_page": null,
    "name": "yuanqi-agent-mcp",
    "maintainer": null,
    "docs_url": null,
    "requires_python": ">=3.10",
    "maintainer_email": null,
    "keywords": "agent, mcp, yuanqi",
    "author": null,
    "author_email": "YuanqiMcp <yuanqi_mcp@tencent.com>",
    "download_url": "https://files.pythonhosted.org/packages/ac/44/98cb347f7bae79ad3f1b302f45da6b7d8c385727fffb8dba754f56dff212/yuanqi_agent_mcp-0.1.7.tar.gz",
    "platform": null,
    "description": "<div align=\"center\">\n<a href=\"https://yuanqi.tencent.com/\" target=\"_blank\" rel=\"noopener\">\n  <picture>\n    <source media=\"(prefers-color-scheme: dark)\" srcset=\"https://open-agents-web-cdn-prd.hunyuan.tencent.com/public/bf6b0f00a2e660e0e35d.png\" />\n    <img alt=\"Framelink\" src=\"https://open-agents-web-cdn-prd.hunyuan.tencent.com/public/bf6b0f00a2e660e0e35d.png\" />\n  </picture>\n</a>\n\n  <h1>\u5143\u5668\u667a\u80fd\u4f53 MCP \u670d\u52a1\u5668</h1>\n  <h3>\u4e3a\u60a8\u7684\u5143\u5668\u667a\u80fd\u4f53\u63d0\u4f9b mcp \u8bbf\u95ee\u80fd\u529b\u3002<br/>\u4e00\u6b21\u6027\u5728\u4efb\u4f55\u667a\u80fd\u4f53\u6846\u67b6\u4e2d\u96c6\u6210\u3002</h3>\n  <a href=\"https://github.com/GLips/Figma-Context-MCP/blob/main/LICENSE\">\n    <img alt=\"MIT \u8bb8\u53ef\u8bc1\" src=\"https://img.shields.io/github/license/GLips/Figma-Context-MCP\" />\n  </a>\n</div>\n<br/>\n<p align=\"center\">\n  <a href=\"https://yuanqi.tencent.com/\">\u5143\u5668</a>\u5b98\u65b9\u667a\u80fd\u4f53\u4e0a\u4e0b\u6587\u534f\u8bae(MCP)\u670d\u52a1\u5668\uff0c\u652f\u6301\u4e0e\u5f3a\u5927\u7684\u5143\u5668\u667a\u80fd\u4f53\u4ea4\u4e92\u3002\u5141\u8bb8MCP\u5ba2\u6237\u7aef\u5982<a href=\"https://www.anthropic.com/claude\">Claude Desktop</a>\u3001<a href=\"https://www.cursor.so\">Cursor</a>\u3001<a href=\"https://codeium.com/windsurf\">Windsurf</a>\u3001<a href=\"https://github.com/openai/openai-agents-python\">OpenAI Agents</a>\u7b49\u8fdb\u884c\u96c6\u6210\u3002\n</p>\n\n## \u5feb\u901f\u5f00\u59cb\u4f7f\u7528 MCP \u5ba2\u6237\u7aef\n\n1. \u4ece[\u5143\u5668\u667a\u80fd\u4f53\u5e73\u53f0](https://yuanqi.tencent.com/)\u83b7\u53d6\u4f60\u5f00\u53d1\u7684\u667a\u80fd\u4f53\u7684 API \u5bc6\u94a5\u3002\n2. \u5b89\u88c5`uv`\uff08Python\u5305\u7ba1\u7406\u5668\uff09\uff0c\u4f7f\u7528`curl -LsSf https://astral.sh/uv/install.sh | sh`\u5b89\u88c5\u6216\u67e5\u770b`uv` [\u4ed3\u5e93](https://github.com/astral-sh/uv)\u83b7\u53d6\u5176\u4ed6\u5b89\u88c5\u65b9\u6cd5\u3002\n3. **\u91cd\u8981\u63d0\u793a: \u6bcf\u4e2a\u5143\u5668\u667a\u80fd\u4f53\u7684ID\u548c\u5bc6\u94a5\u90fd\u4e0d\u76f8\u540c**\uff0c\u4e24\u8005\u9700\u8981\u5339\u914d\uff0c\u5426\u5219\u4f1a\u6709 `token\u9a8c\u8bc1\u5931\u8d25` \u7684\u9519\u8bef\n\n### Claude Desktop\n\n\u524d\u5f80`Claude > Settings > Developer > Edit Config > claude_desktop_config.json`\u5305\u542b\u4ee5\u4e0b\u5185\u5bb9\uff1a\n\n```\n{\n  \"mcpServers\": {\n    \"YuanQiAgent\": {\n      \"command\": \"uvx\",\n      \"args\": [\n        \"yuanqi-agent-mcp\"\n      ],\n      \"env\": {\n        \"TOOL_NAME\": \"\u586b\u5199\u4f60\u63d0\u4f9b\u8c03\u7528\u7684\u5143\u5668\u667a\u80fd\u4f53\u540d\u79f0\",\n        \"TOOL_DESC\": \"\u586b\u5199\u4f60\u63d0\u4f9b\u8c03\u7528\u7684\u5143\u5668\u667a\u80fd\u4f53\u63cf\u8ff0\uff0c\u65b9\u4fbfAI\u5de5\u5177\",\n        \"ASSISTANT_ID\": \"\u586b\u5199\u4f60\u8c03\u7528\u7684\u5143\u5668\u667a\u80fd\u4f53ID\",\n        \"API_KEY\": \"\u586b\u5199\u4f60\u8c03\u7528\u7684\u5143\u5668\u667a\u80fd\u4f53Token\"\n      }\n    }\n  }\n}\n```\n\n\u26a0\ufe0f \u6ce8\u610f\uff1aAPI_KEY\u9700\u8981\u4e0eASSISTANT_ID\u5339\u914d\u3002\u5982\u679c\u51fa\u73b0\u201ctoken\u9a8c\u8bc1\u5931\u8d25\u201d\u9519\u8bef\uff0c\u8bf7\u68c0\u67e5\u60a8\u7684API_KEY\u548cASSISTANT_ID\u3002\n\u5982\u679c\u4f60\u4f7f\u7528Windows\uff0c\u4f60\u9700\u8981\u5728Claude Desktop\u4e2d\u542f\u7528\"\u5f00\u53d1\u8005\u6a21\u5f0f\"\u624d\u80fd\u4f7f\u7528MCP\u670d\u52a1\u5668\u3002\u70b9\u51fb\u5de6\u4e0a\u89d2\u6c49\u5821\u83dc\u5355\u4e2d\u7684\"Help\"\uff0c\u7136\u540e\u9009\u62e9\"Enable Developer Mode\"\u3002\n\n### Cursor\n\n\u524d\u5f80`Cursor -> Preferences -> Cursor Settings -> MCP -> Add new global MCP Server`\u6dfb\u52a0\u4e0a\u8ff0\u914d\u7f6e\u3002\n\n\n## Transport\n\n\u6211\u4eec\u4ec5\u652f\u6301 stdio \u4f20\u8f93\u65b9\u5f0f\n",
    "bugtrack_url": null,
    "license": null,
    "summary": "mcp server to invoke yuanqi agent",
    "version": "0.1.7",
    "project_urls": null,
    "split_keywords": [
        "agent",
        " mcp",
        " yuanqi"
    ],
    "urls": [
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "5770aead54ca00b6e0b601d1ec717c4f910255a5661e683dfbea7e7e60289bac",
                "md5": "17eb5eee68036ef9fb597f802795e2b9",
                "sha256": "c8e85e42f2afec941a14c53ea2392b04765dbd57a504e710c33bba79ce8b4d1d"
            },
            "downloads": -1,
            "filename": "yuanqi_agent_mcp-0.1.7-py3-none-any.whl",
            "has_sig": false,
            "md5_digest": "17eb5eee68036ef9fb597f802795e2b9",
            "packagetype": "bdist_wheel",
            "python_version": "py3",
            "requires_python": ">=3.10",
            "size": 6360,
            "upload_time": "2025-05-06T14:41:06",
            "upload_time_iso_8601": "2025-05-06T14:41:06.001431Z",
            "url": "https://files.pythonhosted.org/packages/57/70/aead54ca00b6e0b601d1ec717c4f910255a5661e683dfbea7e7e60289bac/yuanqi_agent_mcp-0.1.7-py3-none-any.whl",
            "yanked": false,
            "yanked_reason": null
        },
        {
            "comment_text": null,
            "digests": {
                "blake2b_256": "ac4498cb347f7bae79ad3f1b302f45da6b7d8c385727fffb8dba754f56dff212",
                "md5": "5fc5b06702c0fda599bb5dc1a8c70883",
                "sha256": "7343aff0d06a8df174f4dc878f5652bd32b1fb528cfb2a79104f732d70e4129e"
            },
            "downloads": -1,
            "filename": "yuanqi_agent_mcp-0.1.7.tar.gz",
            "has_sig": false,
            "md5_digest": "5fc5b06702c0fda599bb5dc1a8c70883",
            "packagetype": "sdist",
            "python_version": "source",
            "requires_python": ">=3.10",
            "size": 19569,
            "upload_time": "2025-05-06T14:41:07",
            "upload_time_iso_8601": "2025-05-06T14:41:07.232857Z",
            "url": "https://files.pythonhosted.org/packages/ac/44/98cb347f7bae79ad3f1b302f45da6b7d8c385727fffb8dba754f56dff212/yuanqi_agent_mcp-0.1.7.tar.gz",
            "yanked": false,
            "yanked_reason": null
        }
    ],
    "upload_time": "2025-05-06 14:41:07",
    "github": false,
    "gitlab": false,
    "bitbucket": false,
    "codeberg": false,
    "lcname": "yuanqi-agent-mcp"
}
        
Elapsed time: 1.05389s