内容
# ifly-spark-agent-mcp
这是一个使用 MCP Server 调用 iFlytek SparkAgent 平台任务链的简单示例。
## 使用方法
### 本地调试
使用 stdio(默认)或 SSE 传输启动服务器:
```bash
# 使用 stdio 传输(默认)
uv run ifly-spark-agent-mcp
# 在自定义端口上使用 SSE 传输
uv run ifly-spark-agent-mcp --transport sse --port 8000
```
默认情况下,服务器提供一个名为 "upload_file" 的工具,该工具接受一个必需的参数:
- `file`: 上传文件的路径
### MCP 客户端示例
使用 MCP 客户端,您可以通过 STDIO 传输像这样使用该工具:
```python
import asyncio
from mcp.client.session import ClientSession
from mcp.client.stdio import StdioServerParameters, stdio_client
async def main():
async with stdio_client(
StdioServerParameters(command="uv", args=["run", "ifly-spark-agent-mcp"])
) as (read, write):
async with ClientSession(read, write) as session:
await session.initialize()
# 列出可用工具
tools = await session.list_tools()
print(tools)
# 调用 upload_file 工具
result = await session.call_tool("upload_file", {"file": "/path/to/file"})
print(result)
asyncio.run(main())
```
### 使用 MCP 客户端
#### 在 Claude 上使用
要添加一个持久客户端,请将以下内容添加到您的 `claude_desktop_config.json` 或 `mcp.json` 文件中:
##### 1. 使用 uv
```json
{
"mcpServers": {
"ifly-spark-agent-mcp": {
"command": "uv",
"args": [
"--directory",
"/path/to/ifly-spark-agent-mcp",
"run",
"ifly-spark-agent-mcp"
],
"env": {
"IFLY_SPARK_AGENT_BASE_URL": "xxxx",
"IFLY_SPARK_AGENT_APP_ID": "xxxx",
"IFLY_SPARK_AGENT_APP_SECRET": "xxxx"
}
}
}
}
```
##### 2. 使用 uvx 和 GitHub 仓库
```json
{
"mcpServers": {
"ifly-spark-agent-mcp": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/iflytek/ifly-spark-agent-mcp",
"ifly-spark-agent-mcp"
],
"env": {
"IFLY_SPARK_AGENT_BASE_URL": "xxxx",
"IFLY_SPARK_AGENT_APP_ID": "xxxx",
"IFLY_SPARK_AGENT_APP_SECRET": "xxxx"
}
}
}
}
```