finish sdk 0.0.8
This commit is contained in:
parent
4a8385d7ad
commit
3e363c6dde
@ -691,8 +691,6 @@ class McpClientAdapter {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
console.log(args);
|
|
||||||
|
|
||||||
const bridge = useMessageBridge();
|
const bridge = useMessageBridge();
|
||||||
const { code, msg } = await bridge.commandRequest<PromptsGetResponse>('prompts/get', { clientId, promptId, args });
|
const { code, msg } = await bridge.commandRequest<PromptsGetResponse>('prompts/get', { clientId, promptId, args });
|
||||||
return msg;
|
return msg;
|
||||||
|
|||||||
@ -2,123 +2,110 @@
|
|||||||
|
|
||||||
<img src="./icons/openmcp-sdk.svg" height="200px"/>
|
<img src="./icons/openmcp-sdk.svg" height="200px"/>
|
||||||
|
|
||||||
<h3>openmcp-sdk : 适用于 openmcp 的部署框架</h3>
|
<h3>openmcp-sdk: Deployment Framework for OpenMCP</h3>
|
||||||
<h4>闪电般将您的 agent 从实验室部署到生产环境</h4>
|
<h4>Lightning-fast deployment of your agent from lab to production</h4>
|
||||||
|
|
||||||
<a href="https://kirigaya.cn/openmcp" target="_blank" style="display: inline-block; padding: 8px 16px; background-color: #7D3FF8; color: white; border-radius: .5em; text-decoration: none;">📄 OpenMCP 官方文档</a>
|
<a href="https://kirigaya.cn/openmcp" target="_blank" style="display: inline-block; padding: 8px 16px; background-color: #7D3FF8; color: white; border-radius: .5em; text-decoration: none;">📄 OpenMCP Official Documentation</a>
|
||||||
|
|
||||||
|
|
||||||
<a href="https://qm.qq.com/cgi-bin/qm/qr?k=C6ZUTZvfqWoI12lWe7L93cWa1hUsuVT0&jump_from=webapi&authKey=McW6B1ogTPjPDrCyGttS890tMZGQ1KB3QLuG4aqVNRaYp4vlTSgf2c6dMcNjMuBD" target="_blank" style="display: inline-block; padding: 8px 16px; background-color: #CB81DA; color: white; border-radius: .5em; text-decoration: none;">QQ 讨论群</a><a href="https://discord.gg/af5cfB9a" target="_blank" style="display: inline-block; padding: 8px 16px; background-color: rgb(84, 176, 84); color: white; border-radius: .5em; text-decoration: none; margin-left: 5px;">Discord频道</a>
|
<a href="https://qm.qq.com/cgi-bin/qm/qr?k=C6ZUTZvfqWoI12lWe7L93cWa1hUsuVT0&jump_from=webapi&authKey=McW6B1ogTPjPDrCyGttS890tMZGQ1KB3QLuG4aqVNRaYp4vlTSgf2c6dMcNjMuBD" target="_blank" style="display: inline-block; padding: 8px 16px; background-color: #CB81DA; color: white; border-radius: .5em; text-decoration: none;">QQ Discussion Group</a><a href="https://discord.gg/af5cfB9a" target="_blank" style="display: inline-block; padding: 8px 16px; background-color: rgb(84, 176, 84); color: white; border-radius: .5em; text-decoration: none; margin-left: 5px;">Discord Channel</a>
|
||||||
|
|
||||||
</div>
|
</div>
|
||||||
|
|
||||||
|
## Installation
|
||||||
## 安装
|
|
||||||
|
|
||||||
```bash
|
```bash
|
||||||
npm install openmcp-sdk
|
npm install openmcp-sdk
|
||||||
```
|
```
|
||||||
|
|
||||||
> 目前 openmcp-sdk 只支持 esm 模式的导入
|
> Currently, openmcp-sdk only supports ESM-style imports.
|
||||||
|
|
||||||
## 使用
|
## Usage
|
||||||
|
|
||||||
文件名：main.ts
|
Filename: `main.ts`
|
||||||
|
|
||||||
```typescript
|
```typescript
|
||||||
import { TaskLoop } from 'openmcp-sdk/task-loop';
|
import { OmAgent } from 'openmcp-sdk/service/sdk';
|
||||||
import { TaskLoopAdapter } from 'openmcp-sdk/service';
|
|
||||||
async function main() {
|
|
||||||
// 创建适配器，负责通信和 mcp 连接
|
|
||||||
const adapter = new TaskLoopAdapter();
|
|
||||||
|
|
||||||
// 添加 mcp 服务器
|
// create Agent
|
||||||
adapter.addMcp({
|
const agent = new OmAgent();
|
||||||
connectionType: 'STDIO',
|
|
||||||
commandString: 'node index.js',
|
// Load configuration, which can be automatically generated after debugging with openmcp client
|
||||||
cwd: '~/projects/openmcp-tutorial/my-browser/dist'
|
agent.loadMcpConfig('./mcpconfig.json');
|
||||||
});
|
|
||||||
|
|
||||||
// 创建事件循环驱动器, verbose 数值越高，输出的日志越详细
|
// Read the debugged prompt
|
||||||
const taskLoop = new TaskLoop({ adapter, verbose: 1 });
|
const prompt = await agent.getPrompt('hacknews', { topn: '5' });
|
||||||
|
|
||||||
// 获取所有工具
|
// Execute the task
|
||||||
const tools = await taskLoop.getTools();
|
const res = await agent.ainvoke({ messages: prompt });
|
||||||
|
|
||||||
// 配置改次事件循环使用的大模型
|
console.log('⚙️ Agent Response', res);
|
||||||
taskLoop.setLlmConfig({
|
```
|
||||||
id: 'deepseek',
|
|
||||||
baseUrl: 'https://api.deepseek.com/v1',
|
|
||||||
userToken: process.env['DEEPSEEK_API_TOKEN'],
|
|
||||||
userModel: 'deepseek-chat'
|
|
||||||
});
|
|
||||||
|
|
||||||
// 创建当前事件循环对应的上下文，并且配置当前上下文的设置
|
`mcpconfig.json` can be generated from [openmcp client](https://github.com/LSTM-Kirigaya/openmcp-client) directly, you don't have to write it by yourself. Here is the example:
|
||||||
const storage = {
|
|
||||||
messages: [],
|
```json
|
||||||
settings: {
|
{
|
||||||
temperature: 0.7,
|
"version": "1.0.0",
|
||||||
// 在本次对话使用所有工具
|
"namespace": "openmcp",
|
||||||
enableTools: tools,
|
"mcpServers": {
|
||||||
// 系统提示词
|
"my-browser": {
|
||||||
systemPrompt: 'you are a clever bot',
|
"command": "mcp",
|
||||||
// 对话上下文的轮数
|
"args": [
|
||||||
contextLength: 20
|
"run",
|
||||||
|
"~/projects/openmcp-tutorial/crawl4ai-mcp/main.py"
|
||||||
|
],
|
||||||
|
"description": "A MCP for long-term memory support",
|
||||||
|
"prompts": [
|
||||||
|
"hacknews"
|
||||||
|
]
|
||||||
}
|
}
|
||||||
};
|
},
|
||||||
|
"defaultLLM": {
|
||||||
// 本次发出的问题
|
"baseURL": "https://api.deepseek.com",
|
||||||
const message = 'hello world';
|
"apiToken": "sk-xxxxxxxxxxxxxx",
|
||||||
|
"model": "deepseek-chat"
|
||||||
// 开启事件循环
|
}
|
||||||
await taskLoop.start(storage, message);
|
}
|
||||||
|
|
||||||
// 打印上下文，最终的回答在 messages.at(-1) 中
|
|
||||||
const content = storage.messages.at(-1).content;
|
|
||||||
console.log('最终回答：', content);
|
|
||||||
}
|
|
||||||
|
|
||||||
main();
|
|
||||||
```
|
```
|
||||||
|
|
||||||
下面是可能的输出：
|
Run your agent and get example output:
|
||||||
|
|
||||||
```
|
```
|
||||||
[6/5/2025, 8:16:15 PM] 🚀 [my-browser] 0.1.0 connected
|
[2025/6/20 20:47:31] 🚀 [crawl4ai-mcp] 1.9.1 connected
|
||||||
[6/5/2025, 8:16:15 PM] task loop enters a new epoch
|
[2025/6/20 20:47:35] 🤖 Agent wants to use these tools get_web_markdown
|
||||||
[6/5/2025, 8:16:23 PM] task loop finish a epoch
|
[2025/6/20 20:47:35] 🔧 using tool get_web_markdown
|
||||||
[6/5/2025, 8:16:23 PM] 🤖 llm wants to call these tools k_navigate
|
[2025/6/20 20:47:39] ✓ use tools success
|
||||||
[6/5/2025, 8:16:23 PM] 🔧 calling tool k_navigate
|
[2025/6/20 20:47:46] 🤖 Agent wants to use these tools get_web_markdown, get_web_markdown, get_web_markdown
|
||||||
[6/5/2025, 8:16:34 PM] × fail to call tools McpError: MCP error -32603: net::ERR_CONNECTION_RESET at https://towardsdatascience.com/tag/editors-pick/
|
[2025/6/20 20:47:46] 🔧 using tool get_web_markdown
|
||||||
[6/5/2025, 8:16:34 PM] task loop enters a new epoch
|
[2025/6/20 20:47:48] ✓ use tools success
|
||||||
[6/5/2025, 8:16:40 PM] task loop finish a epoch
|
[2025/6/20 20:47:48] 🔧 using tool get_web_markdown
|
||||||
[6/5/2025, 8:16:40 PM] 🤖 llm wants to call these tools k_navigate
|
[2025/6/20 20:47:54] ✓ use tools success
|
||||||
[6/5/2025, 8:16:40 PM] 🔧 calling tool k_navigate
|
[2025/6/20 20:47:54] 🔧 using tool get_web_markdown
|
||||||
[6/5/2025, 8:16:44 PM] ✓ call tools okey dockey success
|
[2025/6/20 20:47:57] ✓ use tools success
|
||||||
[6/5/2025, 8:16:44 PM] task loop enters a new epoch
|
|
||||||
[6/5/2025, 8:16:57 PM] task loop finish a epoch
|
⚙️ Agent Response
|
||||||
[6/5/2025, 8:16:57 PM] 🤖 llm wants to call these tools k_evaluate
|
⌨️ Today's Tech Article Roundup
|
||||||
[6/5/2025, 8:16:57 PM] 🔧 calling tool k_evaluate
|
|
||||||
[6/5/2025, 8:16:57 PM] ✓ call tools okey dockey success
|
📌 How to Detect or Observe Passing Gravitational Waves?
|
||||||
[6/5/2025, 8:16:57 PM] task loop enters a new epoch
|
Summary: This article explores the physics of gravitational waves, explaining their effects on space-time and how humans might perceive or observe this cosmic phenomenon.
|
||||||
[6/5/2025, 8:17:06 PM] task loop finish a epoch
|
Author: ynoxinul
|
||||||
[6/5/2025, 8:17:06 PM] 🤖 llm wants to call these tools k_navigate, k_navigate
|
Posted: 2 hours ago
|
||||||
[6/5/2025, 8:17:06 PM] 🔧 calling tool k_navigate
|
Link: https://physics.stackexchange.com/questions/338912/how-would-a-passing-gravitational-wave-look-or-feel
|
||||||
[6/5/2025, 8:17:09 PM] ✓ call tools okey dockey success
|
|
||||||
[6/5/2025, 8:17:09 PM] 🔧 calling tool k_navigate
|
📌 Learn Makefile Tutorial
|
||||||
[6/5/2025, 8:17:12 PM] ✓ call tools okey dockey success
|
Summary: A comprehensive Makefile tutorial for beginners and advanced users, covering basic syntax, variables, automatic rules, and advanced features to help developers manage project builds efficiently.
|
||||||
[6/5/2025, 8:17:12 PM] task loop enters a new epoch
|
Author: dsego
|
||||||
[6/5/2025, 8:17:19 PM] task loop finish a epoch
|
Posted: 4 hours ago
|
||||||
[6/5/2025, 8:17:19 PM] 🤖 llm wants to call these tools k_evaluate, k_evaluate
|
Link: https://makefiletutorial.com/
|
||||||
[6/5/2025, 8:17:19 PM] 🔧 calling tool k_evaluate
|
|
||||||
[6/5/2025, 8:17:19 PM] ✓ call tools okey dockey success
|
📌 Hurl: Run and Test HTTP Requests in Plain Text
|
||||||
[6/5/2025, 8:17:19 PM] 🔧 calling tool k_evaluate
|
Summary: Hurl is a command-line tool that allows defining and executing HTTP requests in plain text format, ideal for data fetching and HTTP session testing. It supports chained requests, value capture, and response queries, making it perfect for testing REST, SOAP, and GraphQL APIs.
|
||||||
[6/5/2025, 8:17:19 PM] ✓ call tools okey dockey success
|
Author: flykespice
|
||||||
[6/5/2025, 8:17:19 PM] task loop enters a new epoch
|
Posted: 8 hours ago
|
||||||
[6/5/2025, 8:17:45 PM] task loop finish a epoch
|
Link: https://github.com/Orange-OpenSource/hurl
|
||||||
"以下是整理好的热门文章信息，并已翻译为简体中文：\n\n---\n\n### K1 标题 \n**《数据漂移并非真正问题：你的监控策略才是》** \n\n**简介** \n在机器学习领域，数据漂移常被视为模型性能下降的罪魁祸首，但本文作者提出了一种颠覆性的观点：数据漂移只是一个信号，真正的核心问题在于监控策略的不足。文章通过实际案例（如电商推荐系统和金融风控模型）揭示了传统统计监控的局限性，并提出了一个三层监控框架： \n1. **统计监控**：快速检测数据分布变化，但仅作为初步信号。 \n2. **上下文监控**：结合业务逻辑，判断漂移是否对关键指标产生影响。 \n3. **行为监控**：追踪模型预测的实际效果，避免“无声漂移”。 \n\n亮点在于作者强调了监控系统需要与业务目标紧密结合，而非单纯依赖技术指标。 \n\n**原文链接** \n[点击阅读原文](https://towardsdatascience.com/data-drift-is-not-the-actual-problem-your-monitoring-strategy-is/) \n\n---\n\n### K2 标题 \n**《从 Jupyter 到程序员的快速入门指南》** \n\n**简介** \n本文为数据科学家和初学者提供了一条从 Jupyter Notebook 过渡到专业编程的清晰路径。作者通过实际代码示例和工具推荐（如 VS Code、Git 和 Docker），帮助读者摆脱 Notebook 的局限性，提升代码的可维护性和可扩展性。 \n\n亮点包括： \n- 如何将 Notebook 代码模块化为可复用的 Python 脚本。 \n- 使用版本控制和容器化技术优化开发流程。 \n- 实战案例展示如何将实验性代码转化为生产级应用。 \n\n**原文链接** \n[点击阅读原文](https://towardsdatascience.com/the-journey-from-jupyter-to-programmer-a-quick-start-guide/) \n\n---\n\n如果需要进一步优化或补充其他内容，请随时告诉我！"
|
|
||||||
```
|
```
|
||||||
|
|
||||||
更多使用请看官方文档：https://kirigaya.cn/openmcp/sdk-tutorial/
|
For more details, see the official documentation: [https://kirigaya.cn/openmcp/sdk-tutorial/](https://kirigaya.cn/openmcp/sdk-tutorial/)
|
||||||
|
|
||||||
star 我们的项目：https://github.com/LSTM-Kirigaya/openmcp-client
|
Star our project: [https://github.com/LSTM-Kirigaya/openmcp-client](https://github.com/LSTM-Kirigaya/openmcp-client)
|
||||||
|
|||||||
@ -261,7 +261,7 @@ export class OmAgent {
|
|||||||
public async getPrompt(promptId: string, args: Record<string, any>) {
|
public async getPrompt(promptId: string, args: Record<string, any>) {
|
||||||
const loop = await this.getLoop();
|
const loop = await this.getLoop();
|
||||||
|
|
||||||
const prompt = await loop.getPrompt(promptId, args);
|
const prompt = await loop.getPrompt(promptId, JSON.parse(JSON.stringify(args)));
|
||||||
|
|
||||||
return prompt;
|
return prompt;
|
||||||
}
|
}
|
||||||
|
|||||||
Loading…
x
Reference in New Issue
Block a user