完成英文和日文文档的部署
This commit is contained in:
parent
04f2b4e379
commit
04cb224395
@ -10,6 +10,10 @@ import { contributors } from './contributors';
|
||||
import { withMermaid } from "vitepress-plugin-mermaid";
|
||||
import { customIcons } from './theme/hook/icons';
|
||||
|
||||
import enConfig from './i18n/en';
|
||||
import zhConfig from './i18n/zh';
|
||||
import jaConfig from './i18n/ja';
|
||||
|
||||
export const baseUrl = '/openmcp';
|
||||
|
||||
export default withMermaid({
|
||||
@ -30,7 +34,7 @@ export default withMermaid({
|
||||
mapAuthors: contributors
|
||||
}),
|
||||
GitChangelogMarkdownSection({
|
||||
excludes: ['preview/contributors.md', 'index.md']
|
||||
excludes: ['preview/contributors.md', 'index.md', 'en/index.md', 'ja/index.md']
|
||||
}),
|
||||
ThumbnailHashImages(),
|
||||
],
|
||||
@ -65,186 +69,34 @@ export default withMermaid({
|
||||
head: [
|
||||
['link', { rel: 'icon', href: baseUrl + '/images/favicon.svg' }]
|
||||
],
|
||||
themeConfig: {
|
||||
// https://vitepress.dev/reference/default-theme-config
|
||||
nav: [
|
||||
{ text: '首页', link: '/' },
|
||||
{
|
||||
text: '教程',
|
||||
items: [
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: '简介',
|
||||
description: '关于 mcp 和 openmcp，阁下需要知道的 ...',
|
||||
icon: 'openmcp',
|
||||
link: '/plugin-tutorial/'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: '快速开始',
|
||||
description: '通过一个例子快速了解 OpenMCP 的基本概念',
|
||||
icon: 'quick-fill',
|
||||
link: '/plugin-tutorial/quick-start/'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'OpenMCP 使用手册',
|
||||
description: 'OpenMCP Client 的基本使用',
|
||||
icon: 'shiyongshouce',
|
||||
link: '/plugin-tutorial/usage/connect-mcp'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'MCP 服务器开发案例',
|
||||
description: '使用不同语言开发的不同模式的 MCP 服务器',
|
||||
icon: 'yibangonggongyusuan',
|
||||
link: '/plugin-tutorial/examples/mcp-examples'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'FAQ',
|
||||
description: '为您答疑解惑，排忧解难',
|
||||
icon: 'yijianchuli',
|
||||
link: '/plugin-tutorial/faq/help'
|
||||
}
|
||||
},
|
||||
]
|
||||
},
|
||||
{ text: 'SDK', link: '/sdk-tutorial' },
|
||||
{
|
||||
text: '更多',
|
||||
items: [
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: '更新日志',
|
||||
description: '查看项目的更新历史记录',
|
||||
icon: 'a-yusuan2',
|
||||
link: '/preview/changelog'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: '参与 OpenMCP',
|
||||
description: '了解如何参与 OpenMCP 项目的开发和维护',
|
||||
icon: 'shujuzhongxin',
|
||||
link: '/preview/join'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'OpenMCP 贡献者列表',
|
||||
description: '关于参与 OpenMCP 的贡献者们',
|
||||
icon: 'heike',
|
||||
link: '/preview/contributors'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: '资源频道',
|
||||
description: '获取项目相关的资源和信息',
|
||||
icon: 'xinxiang',
|
||||
link: '/preview/channel'
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
],
|
||||
|
||||
sidebar: {
|
||||
'/plugin-tutorial/': [
|
||||
{
|
||||
text: '简介',
|
||||
items: [
|
||||
{ text: 'OpenMCP 概述', link: '/plugin-tutorial/index' },
|
||||
{ text: '什么是 MCP？', link: '/plugin-tutorial/what-is-mcp' },
|
||||
{ text: 'MCP 基础概念', link: '/plugin-tutorial/concept' }
|
||||
]
|
||||
},
|
||||
{
|
||||
text: '快速开始',
|
||||
items: [
|
||||
{ text: '快速开始', link: '/plugin-tutorial/quick-start' },
|
||||
{ text: '安装 OpenMCP', link: '/plugin-tutorial/quick-start/acquire-openmcp' },
|
||||
{ text: '你的第一个 MCP', link: '/plugin-tutorial/quick-start/first-mcp' },
|
||||
{ text: '快速调试 MCP', link: '/plugin-tutorial/quick-start/quick-debug' },
|
||||
{ text: '扔进大模型里面测测好坏！', link: '/plugin-tutorial/quick-start/put-into-llm' },
|
||||
]
|
||||
},
|
||||
{
|
||||
text: "OpenMCP 使用手册",
|
||||
items: [
|
||||
{ text: 'UI 配色', link: '/plugin-tutorial/usage/ui-color' },
|
||||
{ text: '连接 mcp 服务器', link: '/plugin-tutorial/usage/connect-mcp' },
|
||||
{ text: '调试 tools, resources 和 prompts', link: '/plugin-tutorial/usage/debug' },
|
||||
{ text: '连接大模型', link: '/plugin-tutorial/usage/connect-llm' },
|
||||
{ text: '用大模型测试您的 mcp', link: '/plugin-tutorial/usage/test-with-llm' },
|
||||
{ text: '连接多个 MCP 服务器', link: '/plugin-tutorial/usage/multi-server' },
|
||||
{ text: '分发您的实验结果', link: '/plugin-tutorial/usage/distribute-result' },
|
||||
{ text: 'SSE 在线部署的鉴权器实现', link: '/plugin-tutorial/usage/sse-oauth2' },
|
||||
]
|
||||
},
|
||||
{
|
||||
text: "MCP 服务器开发案例",
|
||||
items: [
|
||||
{ text: 'MCP 服务器开发案例', link: '/plugin-tutorial/examples/mcp-examples' },
|
||||
{ text: '例子 1. python 实现天气信息 mcp 服务器 (STDIO)', link: '/plugin-tutorial/examples/python-simple-stdio' },
|
||||
{ text: '例子 2. go 实现 neo4j 的只读 mcp 服务器 (SSE)', link: '/plugin-tutorial/examples/go-neo4j-sse' },
|
||||
{ text: '例子 3. java 实现文档数据库的只读 mcp (HTTP)', link: '/plugin-tutorial/examples/java-es-http' },
|
||||
{ text: '例子 4. typescript 实现基于 crawl4ai 的超级网页爬虫 mcp (STDIO)', link: '/plugin-tutorial/examples/typescript-crawl4ai-stdio' },
|
||||
{ text: '例子 5. python 实现进行通用表单填充 的 mcp (STDIO)', link: '/plugin-tutorial/examples/python-form-stdio' },
|
||||
{ text: '例子 6. python 实现基于 blender 的 mcp (STDIO)', link: '/plugin-tutorial/examples/python-blender-stdio' },
|
||||
{ text: '例子 7. python 实现 cadence EDA 的 mcp (STDIO)', link: '/plugin-tutorial/examples/python-cadence-stdio' },
|
||||
]
|
||||
},
|
||||
{
|
||||
text: 'FAQ',
|
||||
items: [
|
||||
{ text: '帮助', link: '/plugin-tutorial/faq/help' },
|
||||
]
|
||||
}
|
||||
],
|
||||
|
||||
'/sdk-tutorial/': [
|
||||
{
|
||||
text: '简介',
|
||||
items: [
|
||||
{ text: 'openmcp-sdk.js', link: '/sdk-tutorial/' },
|
||||
]
|
||||
},
|
||||
{
|
||||
text: '基本使用',
|
||||
items: [
|
||||
{ text: '最简单的对话', link: '/sdk-tutorial/usage/greet' },
|
||||
{ text: '任务循环', link: '/sdk-tutorial/usage/task-loop' },
|
||||
{ text: '多服务器连接', link: '/sdk-tutorial/usage/multi-server' },
|
||||
]
|
||||
}
|
||||
]
|
||||
locales: {
|
||||
root: {
|
||||
label: '中文',
|
||||
lang: 'zh',
|
||||
themeConfig: zhConfig
|
||||
},
|
||||
en: {
|
||||
label: 'English',
|
||||
lang: 'en',
|
||||
link: '/en/',
|
||||
themeConfig: enConfig
|
||||
},
|
||||
ja: {
|
||||
label: '日本語',
|
||||
lang: 'ja',
|
||||
link: '/ja/',
|
||||
themeConfig: jaConfig
|
||||
}
|
||||
},
|
||||
|
||||
themeConfig: {
|
||||
|
||||
socialLinks: [
|
||||
{ icon: 'github', link: 'https://github.com/LSTM-Kirigaya/openmcp-client' },
|
||||
{ icon: customIcons.share, link: 'https://kirigaya.cn/home' },
|
||||
],
|
||||
|
||||
footer: {
|
||||
message: '缩短LLM到Agent的最后一公里',
|
||||
copyright: 'OpenMCP All rights reserved'
|
||||
},
|
||||
|
||||
search: {
|
||||
provider: 'local'
|
||||
},
|
||||
|
||||
168
.vitepress/i18n/en.ts
Normal file
168
.vitepress/i18n/en.ts
Normal file
@ -0,0 +1,168 @@
|
||||
export default {
|
||||
nav: [
|
||||
{ text: 'Home', link: '/' },
|
||||
{
|
||||
text: 'Tutorials',
|
||||
items: [
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'Introduction',
|
||||
description: 'What you need to know about MCP and OpenMCP...',
|
||||
icon: 'openmcp',
|
||||
link: '/en/plugin-tutorial/'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'Quick Start',
|
||||
description: 'Understand the basic concept of OpenMCP through an example',
|
||||
icon: 'quick-fill',
|
||||
link: '/en/plugin-tutorial/quick-start/'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'OpenMCP User Guide',
|
||||
description: 'Basic usage of the OpenMCP Client',
|
||||
icon: 'shiyongshouce',
|
||||
link: '/en/plugin-tutorial/usage/connect-mcp'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'MCP Server Examples',
|
||||
description: 'Examples of MCP servers developed in various languages and models',
|
||||
icon: 'yibangonggongyusuan',
|
||||
link: '/en/plugin-tutorial/examples/mcp-examples'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'FAQ',
|
||||
description: 'Answers to your questions and solutions to your problems',
|
||||
icon: 'yijianchuli',
|
||||
link: '/en/plugin-tutorial/faq/help'
|
||||
}
|
||||
},
|
||||
]
|
||||
|
||||
},
|
||||
{ text: 'SDK', link: '/en/sdk-tutorial/' },
|
||||
{
|
||||
text: 'More',
|
||||
items: [
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'Changelog',
|
||||
description: 'View the project update history',
|
||||
icon: 'a-yusuan2',
|
||||
link: '/en/preview/changelog'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'Join OpenMCP',
|
||||
description: 'Learn how to participate in the development and maintenance of OpenMCP',
|
||||
icon: 'shujuzhongxin',
|
||||
link: '/en/preview/join'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'OpenMCP Contributors',
|
||||
description: 'About the people who contributed to OpenMCP',
|
||||
icon: 'heike',
|
||||
link: '/en/preview/contributors'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'Resource Channel',
|
||||
description: 'Access resources and information related to the project',
|
||||
icon: 'xinxiang',
|
||||
link: '/en/preview/channel'
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
sidebar: {
|
||||
'/en/plugin-tutorial/': [
|
||||
{
|
||||
text: 'Overview',
|
||||
items: [
|
||||
{ text: 'Introduction to OpenMCP', link: '/en/plugin-tutorial/index' },
|
||||
{ text: 'What is MCP?', link: '/en/plugin-tutorial/what-is-mcp' },
|
||||
{ text: 'Basic Concepts of MCP', link: '/en/plugin-tutorial/concept' }
|
||||
]
|
||||
},
|
||||
{
|
||||
text: 'Quick Start',
|
||||
items: [
|
||||
{ text: 'Quick Start', link: '/en/plugin-tutorial/quick-start' },
|
||||
{ text: 'Install OpenMCP', link: '/en/plugin-tutorial/quick-start/acquire-openmcp' },
|
||||
{ text: 'Your First MCP', link: '/en/plugin-tutorial/quick-start/first-mcp' },
|
||||
{ text: 'Quick Debugging of MCP', link: '/en/plugin-tutorial/quick-start/quick-debug' },
|
||||
{ text: 'Throw it into an LLM and test it!', link: '/en/plugin-tutorial/quick-start/put-into-llm' }
|
||||
]
|
||||
},
|
||||
{
|
||||
text: 'User Guide',
|
||||
items: [
|
||||
{ text: 'UI Color Settings', link: '/en/plugin-tutorial/usage/ui-color' },
|
||||
{ text: 'Connect to MCP Server', link: '/en/plugin-tutorial/usage/connect-mcp' },
|
||||
{ text: 'Debug tools, resources, and prompts', link: '/en/plugin-tutorial/usage/debug' },
|
||||
{ text: 'Connect to LLM', link: '/en/plugin-tutorial/usage/connect-llm' },
|
||||
{ text: 'Test Your MCP with an LLM', link: '/en/plugin-tutorial/usage/test-with-llm' },
|
||||
{ text: 'Connect to Multiple MCP Services', link: '/en/plugin-tutorial/usage/multi-server' },
|
||||
{ text: 'Distribute Experiment Results', link: '/en/plugin-tutorial/usage/distribute-result' },
|
||||
{ text: 'Implement SSE Authenticator', link: '/en/plugin-tutorial/usage/sse-oauth2' }
|
||||
]
|
||||
},
|
||||
{
|
||||
text: 'Development Examples',
|
||||
items: [
|
||||
{ text: 'MCP Server Development Examples', link: '/en/plugin-tutorial/examples/mcp-examples' },
|
||||
{ text: 'Example 1: Weather Info MCP in Python (STDIO)', link: '/en/plugin-tutorial/examples/python-simple-stdio' },
|
||||
{ text: 'Example 2: Read-only Neo4j MCP in Go (SSE)', link: '/en/plugin-tutorial/examples/go-neo4j-sse' },
|
||||
{ text: 'Example 3: Read-only Document DB MCP in Java (HTTP)', link: '/en/plugin-tutorial/examples/java-es-http' },
|
||||
{ text: 'Example 4: Super Web Crawler MCP in TypeScript using crawl4ai (STDIO)', link: '/en/plugin-tutorial/examples/typescript-crawl4ai-stdio' },
|
||||
{ text: 'Example 5: Generic Form Filling MCP in Python (STDIO)', link: '/en/plugin-tutorial/examples/python-form-stdio' },
|
||||
{ text: 'Example 6: Blender-based MCP in Python (STDIO)', link: '/en/plugin-tutorial/examples/python-blender-stdio' },
|
||||
{ text: 'Example 7: Cadence EDA MCP in Python (STDIO)', link: '/en/plugin-tutorial/examples/python-cadence-stdio' }
|
||||
]
|
||||
},
|
||||
{
|
||||
text: 'FAQ',
|
||||
items: [
|
||||
{ text: 'Help', link: '/en/plugin-tutorial/faq/help' }
|
||||
]
|
||||
}
|
||||
],
|
||||
'/en/sdk-tutorial/': [
|
||||
{
|
||||
text: 'Overview',
|
||||
items: [
|
||||
{ text: 'openmcp‑sdk.js', link: '/en/sdk-tutorial/' }
|
||||
]
|
||||
},
|
||||
{
|
||||
text: 'Basic Usage',
|
||||
items: [
|
||||
{ text: 'Simplest Conversation', link: '/en/sdk-tutorial/usage/greet' },
|
||||
{ text: 'Task Loop', link: '/en/sdk-tutorial/usage/task-loop' },
|
||||
{ text: 'Multiple Server Connections', link: '/en/sdk-tutorial/usage/multi-server' }
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
168
.vitepress/i18n/ja.ts
Normal file
168
.vitepress/i18n/ja.ts
Normal file
@ -0,0 +1,168 @@
|
||||
export default {
|
||||
nav: [
|
||||
{ text: 'ホーム', link: '/' },
|
||||
{
|
||||
text: 'チュートリアル',
|
||||
items: [
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: '概要',
|
||||
description: 'MCPとOpenMCPについて知っておくべきこと...',
|
||||
icon: 'openmcp',
|
||||
link: '/ja/plugin-tutorial/'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'クイックスタート',
|
||||
description: '例を通してOpenMCPの基本概念を素早く理解しましょう',
|
||||
icon: 'quick-fill',
|
||||
link: '/ja/plugin-tutorial/quick-start/'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'OpenMCPユーザーガイド',
|
||||
description: 'OpenMCPクライアントの基本的な使い方',
|
||||
icon: 'shiyongshouce',
|
||||
link: '/ja/plugin-tutorial/usage/connect-mcp'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'MCPサーバー開発例',
|
||||
description: 'さまざまな言語と方式で開発されたMCPサーバーの例',
|
||||
icon: 'yibangonggongyusuan',
|
||||
link: '/ja/plugin-tutorial/examples/mcp-examples'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'FAQ（よくある質問）',
|
||||
description: '質問への回答と問題の解決策をご提供します',
|
||||
icon: 'yijianchuli',
|
||||
link: '/ja/plugin-tutorial/faq/help'
|
||||
}
|
||||
},
|
||||
]
|
||||
|
||||
},
|
||||
{ text: 'SDK', link: '/ja/sdk-tutorial/' },
|
||||
{
|
||||
text: 'もっと見る',
|
||||
items: [
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: '更新履歴',
|
||||
description: 'プロジェクトの更新履歴を見る',
|
||||
icon: 'a-yusuan2',
|
||||
link: '/ja/preview/changelog'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'OpenMCP に参加',
|
||||
description: 'OpenMCP プロジェクトの開発と保守への参加方法を知る',
|
||||
icon: 'shujuzhongxin',
|
||||
link: '/ja/preview/join'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'OpenMCP 貢献者リスト',
|
||||
description: 'OpenMCP に貢献したメンバーについて',
|
||||
icon: 'heike',
|
||||
link: '/ja/preview/contributors'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'リソースチャンネル',
|
||||
description: 'プロジェクトに関連するリソースや情報を取得する',
|
||||
icon: 'xinxiang',
|
||||
link: '/ja/preview/channel'
|
||||
}
|
||||
}
|
||||
]
|
||||
}
|
||||
],
|
||||
sidebar: {
|
||||
'/ja/plugin-tutorial/': [
|
||||
{
|
||||
text: '概要',
|
||||
items: [
|
||||
{ text: 'OpenMCP の概要', link: '/ja/plugin-tutorial/index' },
|
||||
{ text: 'MCP とは？', link: '/ja/plugin-tutorial/what-is-mcp' },
|
||||
{ text: 'MCP の基本概念', link: '/ja/plugin-tutorial/concept' }
|
||||
]
|
||||
},
|
||||
{
|
||||
text: 'クイックスタート',
|
||||
items: [
|
||||
{ text: 'クイックスタート', link: '/ja/plugin-tutorial/quick-start' },
|
||||
{ text: 'OpenMCP のインストール', link: '/ja/plugin-tutorial/quick-start/acquire-openmcp' },
|
||||
{ text: '最初の MCP', link: '/ja/plugin-tutorial/quick-start/first-mcp' },
|
||||
{ text: 'MCP のクイックデバッグ', link: '/ja/plugin-tutorial/quick-start/quick-debug' },
|
||||
{ text: '大規模言語モデルで試してみよう！', link: '/ja/plugin-tutorial/quick-start/put-into-llm' }
|
||||
]
|
||||
},
|
||||
{
|
||||
text: '使用ガイド',
|
||||
items: [
|
||||
{ text: 'UI カラー設定', link: '/ja/plugin-tutorial/usage/ui-color' },
|
||||
{ text: 'MCP サーバーへの接続', link: '/ja/plugin-tutorial/usage/connect-mcp' },
|
||||
{ text: 'tools・resources・prompts のデバッグ', link: '/ja/plugin-tutorial/usage/debug' },
|
||||
{ text: '大規模言語モデルへの接続', link: '/ja/plugin-tutorial/usage/connect-llm' },
|
||||
{ text: '大規模言語モデルで MCP をテストする', link: '/ja/plugin-tutorial/usage/test-with-llm' },
|
||||
{ text: '複数 MCP サーバーの接続', link: '/ja/plugin-tutorial/usage/multi-server' },
|
||||
{ text: '実験結果の配布', link: '/ja/plugin-tutorial/usage/distribute-result' },
|
||||
{ text: 'SSE 認証の実装', link: '/ja/plugin-tutorial/usage/sse-oauth2' }
|
||||
]
|
||||
},
|
||||
{
|
||||
text: '開発事例',
|
||||
items: [
|
||||
{ text: 'MCP サーバー開発事例', link: '/ja/plugin-tutorial/examples/mcp-examples' },
|
||||
{ text: '例 1. Python による天気情報 MCP サーバー (STDIO)', link: '/ja/plugin-tutorial/examples/python-simple-stdio' },
|
||||
{ text: '例 2. Go による neo4j 読み取り専用 MCP サーバー (SSE)', link: '/ja/plugin-tutorial/examples/go-neo4j-sse' },
|
||||
{ text: '例 3. Java によるドキュメントデータベース MCP (HTTP)', link: '/ja/plugin-tutorial/examples/java-es-http' },
|
||||
{ text: '例 4. TypeScript による crawl4ai ベースのスーパーウェブクローラー MCP (STDIO)', link: '/ja/plugin-tutorial/examples/typescript-crawl4ai-stdio' },
|
||||
{ text: '例 5. Python による汎用フォーム入力 MCP (STDIO)', link: '/ja/plugin-tutorial/examples/python-form-stdio' },
|
||||
{ text: '例 6. Python による Blender ベース MCP (STDIO)', link: '/ja/plugin-tutorial/examples/python-blender-stdio' },
|
||||
{ text: '例 7. Python による Cadence EDA MCP (STDIO)', link: '/ja/plugin-tutorial/examples/python-cadence-stdio' }
|
||||
]
|
||||
},
|
||||
{
|
||||
text: 'よくある質問',
|
||||
items: [
|
||||
{ text: 'ヘルプ', link: '/ja/plugin-tutorial/faq/help' }
|
||||
]
|
||||
}
|
||||
],
|
||||
'/ja/sdk-tutorial/': [
|
||||
{
|
||||
text: '概要',
|
||||
items: [
|
||||
{ text: 'openmcp‑sdk.js', link: '/ja/sdk-tutorial/' }
|
||||
]
|
||||
},
|
||||
{
|
||||
text: '基本的な使い方',
|
||||
items: [
|
||||
{ text: '最もシンプルな会話', link: '/ja/sdk-tutorial/usage/greet' },
|
||||
{ text: 'タスクループ', link: '/ja/sdk-tutorial/usage/task-loop' },
|
||||
{ text: '複数サーバー接続', link: '/ja/sdk-tutorial/usage/multi-server' }
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
167
.vitepress/i18n/zh.ts
Normal file
167
.vitepress/i18n/zh.ts
Normal file
@ -0,0 +1,167 @@
|
||||
export default {
|
||||
nav: [
|
||||
{ text: '首页', link: '/' },
|
||||
{
|
||||
text: '教程',
|
||||
items: [
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: '简介',
|
||||
description: '关于 mcp 和 openmcp，阁下需要知道的 ...',
|
||||
icon: 'openmcp',
|
||||
link: '/plugin-tutorial/'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: '快速开始',
|
||||
description: '通过一个例子快速了解 OpenMCP 的基本概念',
|
||||
icon: 'quick-fill',
|
||||
link: '/plugin-tutorial/quick-start/'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'OpenMCP 使用手册',
|
||||
description: 'OpenMCP Client 的基本使用',
|
||||
icon: 'shiyongshouce',
|
||||
link: '/plugin-tutorial/usage/connect-mcp'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'MCP 服务器开发案例',
|
||||
description: '使用不同语言开发的不同模式的 MCP 服务器',
|
||||
icon: 'yibangonggongyusuan',
|
||||
link: '/plugin-tutorial/examples/mcp-examples'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'FAQ',
|
||||
description: '为您答疑解惑，排忧解难',
|
||||
icon: 'yijianchuli',
|
||||
link: '/plugin-tutorial/faq/help'
|
||||
}
|
||||
},
|
||||
]
|
||||
},
|
||||
{ text: 'SDK', link: '/sdk-tutorial/' },
|
||||
{
|
||||
text: '更多',
|
||||
items: [
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: '更新日志',
|
||||
description: '查看项目的更新历史记录',
|
||||
icon: 'a-yusuan2',
|
||||
link: '/preview/changelog'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: '参与 OpenMCP',
|
||||
description: '了解如何参与 OpenMCP 项目的开发和维护',
|
||||
icon: 'shujuzhongxin',
|
||||
link: '/preview/join'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: 'OpenMCP 贡献者列表',
|
||||
description: '关于参与 OpenMCP 的贡献者们',
|
||||
icon: 'heike',
|
||||
link: '/preview/contributors'
|
||||
}
|
||||
},
|
||||
{
|
||||
component: 'KNavItem',
|
||||
props: {
|
||||
title: '资源频道',
|
||||
description: '获取项目相关的资源和信息',
|
||||
icon: 'xinxiang',
|
||||
link: '/preview/channel'
|
||||
}
|
||||
}
|
||||
]
|
||||
},
|
||||
],
|
||||
sidebar: {
|
||||
'/plugin-tutorial/': [
|
||||
{
|
||||
text: '简介',
|
||||
items: [
|
||||
{ text: 'OpenMCP 概述', link: '/plugin-tutorial/index' },
|
||||
{ text: '什么是 MCP？', link: '/plugin-tutorial/what-is-mcp' },
|
||||
{ text: 'MCP 基础概念', link: '/plugin-tutorial/concept' },
|
||||
]
|
||||
},
|
||||
{
|
||||
text: '快速开始',
|
||||
items: [
|
||||
{ text: '快速开始', link: '/plugin-tutorial/quick-start' },
|
||||
{ text: '安装 OpenMCP', link: '/plugin-tutorial/quick-start/acquire-openmcp' },
|
||||
{ text: '你的第一个 MCP', link: '/plugin-tutorial/quick-start/first-mcp' },
|
||||
{ text: '快速调试 MCP', link: '/plugin-tutorial/quick-start/quick-debug' },
|
||||
{ text: '扔进大模型里面测测好坏！', link: '/plugin-tutorial/quick-start/put-into-llm' },
|
||||
]
|
||||
},
|
||||
{
|
||||
text: '使用手册',
|
||||
items: [
|
||||
{ text: 'UI 配色', link: '/plugin-tutorial/usage/ui-color' },
|
||||
{ text: '连接 MCP 服务器', link: '/plugin-tutorial/usage/connect-mcp' },
|
||||
{ text: '调试 tools, resources 和 prompts', link: '/plugin-tutorial/usage/debug' },
|
||||
{ text: '连接大模型', link: '/plugin-tutorial/usage/connect-llm' },
|
||||
{ text: '用大模型测试你的 MCP', link: '/plugin-tutorial/usage/test-with-llm' },
|
||||
{ text: '连接多个 MCP 服务', link: '/plugin-tutorial/usage/multi-server' },
|
||||
{ text: '分发实验结果', link: '/plugin-tutorial/usage/distribute-result' },
|
||||
{ text: 'SSE 鉴权器实现', link: '/plugin-tutorial/usage/sse-oauth2' },
|
||||
]
|
||||
},
|
||||
{
|
||||
text: '开发案例',
|
||||
items: [
|
||||
{ text: 'MCP 服务器开发案例', link: '/plugin-tutorial/examples/mcp-examples' },
|
||||
{ text: '例子 1. python 实现天气信息 mcp 服务器 (STDIO)', link: '/plugin-tutorial/examples/python-simple-stdio' },
|
||||
{ text: '例子 2. go 实现 neo4j 的只读 mcp 服务器 (SSE)', link: '/plugin-tutorial/examples/go-neo4j-sse' },
|
||||
{ text: '例子 3. java 实现文档数据库的只读 mcp (HTTP)', link: '/plugin-tutorial/examples/java-es-http' },
|
||||
{ text: '例子 4. typescript 实现基于 crawl4ai 的超级网页爬虫 mcp (STDIO)', link: '/plugin-tutorial/examples/typescript-crawl4ai-stdio' },
|
||||
{ text: '例子 5. python 实现进行通用表单填充 的 mcp (STDIO)', link: '/plugin-tutorial/examples/python-form-stdio' },
|
||||
{ text: '例子 6. python 实现基于 blender 的 mcp (STDIO)', link: '/plugin-tutorial/examples/python-blender-stdio' },
|
||||
{ text: '例子 7. python 实现 cadence EDA 的 mcp (STDIO)', link: '/plugin-tutorial/examples/python-cadence-stdio' },
|
||||
]
|
||||
},
|
||||
{
|
||||
text: 'FAQ',
|
||||
items: [
|
||||
{ text: '帮助', link: '/plugin-tutorial/faq/help' },
|
||||
]
|
||||
}
|
||||
],
|
||||
'/sdk-tutorial/': [
|
||||
{
|
||||
text: '简介',
|
||||
items: [
|
||||
{ text: 'openmcp‑sdk.js', link: '/sdk-tutorial/' },
|
||||
]
|
||||
},
|
||||
{
|
||||
text: '基本使用',
|
||||
items: [
|
||||
{ text: '最简单的对话', link: '/sdk-tutorial/usage/greet' },
|
||||
{ text: '任务循环', link: '/sdk-tutorial/usage/task-loop' },
|
||||
{ text: '多服务器连接', link: '/sdk-tutorial/usage/multi-server' },
|
||||
]
|
||||
}
|
||||
]
|
||||
}
|
||||
}
|
||||
@ -10,7 +10,7 @@
|
||||
</template>
|
||||
|
||||
<script setup lang="ts">
|
||||
import { useData, useRouter } from 'vitepress';
|
||||
import { useData, useRouter, inBrowser } from 'vitepress';
|
||||
import DefaultTheme from 'vitepress/theme';
|
||||
import { nextTick, onMounted, provide, ref } from 'vue';
|
||||
import mediumZoom from "medium-zoom";
|
||||
@ -21,13 +21,21 @@ import HeroImage from './components/home/HeroImage.vue';
|
||||
|
||||
import { gsap } from "gsap/dist/gsap";
|
||||
import { ScrollTrigger } from "gsap/dist/ScrollTrigger";
|
||||
import { watchEffect } from 'vue';
|
||||
|
||||
const data = useData()
|
||||
const router = useRouter()
|
||||
const data = useData();
|
||||
const router = useRouter();
|
||||
const enableTransitions = () =>
|
||||
'startViewTransition' in document &&
|
||||
window.matchMedia('(prefers-reduced-motion: no-preference)').matches;
|
||||
|
||||
// 用户浏览器保存 cookies
|
||||
watchEffect(() => {
|
||||
if (inBrowser) {
|
||||
document.cookie = `nf_lang=${data.lang.value}; expires=Mon, 1 Jan 2030 00:00:00 UTC; path=/`;
|
||||
}
|
||||
})
|
||||
|
||||
const isDark = data.isDark;
|
||||
const mounted = ref(false);
|
||||
|
||||
@ -120,14 +128,14 @@ function makeHomeAnimation() {
|
||||
];
|
||||
|
||||
elements.forEach(element => {
|
||||
gsap.fromTo(element.selector,
|
||||
gsap.fromTo(element.selector,
|
||||
{
|
||||
opacity: 0,
|
||||
y: 100,
|
||||
duration: 1.2,
|
||||
ease: "power2.out",
|
||||
},
|
||||
{
|
||||
{
|
||||
opacity: 1,
|
||||
y: 0,
|
||||
duration: 1.2, // 延长动画时间
|
||||
@ -173,5 +181,4 @@ body::-webkit-scrollbar {
|
||||
.medium-zoom-image--opened {
|
||||
z-index: 999;
|
||||
}
|
||||
|
||||
</style>
|
||||
@ -33,9 +33,9 @@ const tabsContainer = reactive({
|
||||
paneInfos: [] as PaneInfo[],
|
||||
panes: [] as HTMLElement[],
|
||||
lastPaneId: 0,
|
||||
panelContainer: undefined as HTMLElement | undefined,
|
||||
panelContainer: undefined as any,
|
||||
|
||||
getPanes(el: HTMLElement | null, id: number) {
|
||||
getPanes(el: any, id: number) {
|
||||
if (el) this.panes[id] = el;
|
||||
},
|
||||
|
||||
@ -150,9 +150,19 @@ onMounted(() => {
|
||||
transform: scale(1.05);
|
||||
}
|
||||
|
||||
.k-tabs-content {
|
||||
html[lang="zh"] .k-tabs-content {
|
||||
position: relative;
|
||||
min-height: 200px;
|
||||
min-height: 500px;
|
||||
}
|
||||
|
||||
html[lang="en"] .k-tabs-content {
|
||||
position: relative;
|
||||
min-height: 600px;
|
||||
}
|
||||
|
||||
html[lang="ja"] .k-tabs-content {
|
||||
position: relative;
|
||||
min-height: 600px;
|
||||
}
|
||||
|
||||
.k-tabs-content>* {
|
||||
|
||||
@ -272,7 +272,7 @@ iframe {
|
||||
background-clip: text;
|
||||
-webkit-text-fill-color: var(--vp-home-hero-name-color);
|
||||
}
|
||||
|
||||
/*
|
||||
.VPHero .heading .text {
|
||||
}
|
||||
|
||||
@ -281,7 +281,7 @@ iframe {
|
||||
|
||||
.VPHero .actions {
|
||||
}
|
||||
|
||||
*/
|
||||
|
||||
#home-0 {
|
||||
font-size: 40px;
|
||||
|
||||
BIN
en/images/.DS_Store
vendored
Normal file
BIN
en/images/.DS_Store
vendored
Normal file
Binary file not shown.
71
en/images/favicon.svg
Normal file
71
en/images/favicon.svg
Normal file
@ -0,0 +1,71 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<svg width="612" height="612" viewBox="0 0 612 612" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<defs>
|
||||
<linearGradient id="gradient_1" gradientUnits="userSpaceOnUse" x1="300" y1="0" x2="300" y2="600">
|
||||
<stop offset="0" stop-color="#A1A7F6" />
|
||||
<stop offset="1" stop-color="#FFFFFF" stop-opacity="0.2" />
|
||||
</linearGradient>
|
||||
<linearGradient id="gradient_2" gradientUnits="userSpaceOnUse" x1="110.5" y1="0" x2="110.5" y2="221">
|
||||
<stop offset="0.468" stop-color="#BFBAF6" />
|
||||
<stop offset="1" stop-color="#FFFFFF" />
|
||||
</linearGradient>
|
||||
<filter color-interpolation-filters="sRGB" x="-219" y="-219" width="221" height="221" id="filter_3">
|
||||
<feFlood flood-opacity="0" result="BackgroundImageFix_1" />
|
||||
<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0" in="SourceAlpha" />
|
||||
<feOffset dx="0" dy="4" />
|
||||
<feGaussianBlur stdDeviation="2" />
|
||||
<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.251 0" />
|
||||
<feBlend mode="normal" in2="BackgroundImageFix_1" result="Shadow_2" />
|
||||
<feBlend mode="normal" in="SourceGraphic" in2="Shadow_2" result="Shape_3" />
|
||||
</filter>
|
||||
<linearGradient id="gradient_4" gradientUnits="userSpaceOnUse" x1="55.5" y1="0" x2="55.5" y2="111">
|
||||
<stop offset="0" stop-color="#FFFFFF" />
|
||||
<stop offset="1" stop-color="#A8A7F3" />
|
||||
</linearGradient>
|
||||
<filter color-interpolation-filters="sRGB" x="-109" y="-109" width="111" height="111" id="filter_5">
|
||||
<feFlood flood-opacity="0" result="BackgroundImageFix_1" />
|
||||
<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0" in="SourceAlpha" />
|
||||
<feOffset dx="0" dy="4" />
|
||||
<feGaussianBlur stdDeviation="2" />
|
||||
<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.251 0" />
|
||||
<feBlend mode="normal" in2="BackgroundImageFix_1" result="Shadow_2" />
|
||||
<feBlend mode="normal" in="SourceGraphic" in2="Shadow_2" result="Shape_3" />
|
||||
</filter>
|
||||
<linearGradient id="gradient_6" gradientUnits="userSpaceOnUse" x1="174" y1="0" x2="174" y2="348">
|
||||
<stop offset="0.182" stop-color="#A594F6" />
|
||||
<stop offset="1" stop-color="#F4E5FF" />
|
||||
</linearGradient>
|
||||
<filter color-interpolation-filters="sRGB" x="-346" y="-346" width="348" height="348" id="filter_7">
|
||||
<feFlood flood-opacity="0" result="BackgroundImageFix_1" />
|
||||
<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0" in="SourceAlpha" />
|
||||
<feOffset dx="0" dy="4" />
|
||||
<feGaussianBlur stdDeviation="2" />
|
||||
<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.251 0" />
|
||||
<feBlend mode="normal" in2="BackgroundImageFix_1" result="Shadow_2" />
|
||||
<feBlend mode="normal" in="SourceGraphic" in2="Shadow_2" result="Shape_3" />
|
||||
</filter>
|
||||
<linearGradient id="gradient_8" gradientUnits="userSpaceOnUse" x1="57" y1="0" x2="57" y2="114">
|
||||
<stop offset="0" stop-color="#FFFFFF" />
|
||||
<stop offset="0.614" stop-color="#C7BAF8" />
|
||||
</linearGradient>
|
||||
<filter color-interpolation-filters="sRGB" x="-112" y="-112" width="114" height="114" id="filter_9">
|
||||
<feFlood flood-opacity="0" result="BackgroundImageFix_1" />
|
||||
<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0" in="SourceAlpha" />
|
||||
<feOffset dx="0" dy="4" />
|
||||
<feGaussianBlur stdDeviation="2" />
|
||||
<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.251 0" />
|
||||
<feBlend mode="normal" in2="BackgroundImageFix_1" result="Shadow_2" />
|
||||
<feBlend mode="normal" in="SourceGraphic" in2="Shadow_2" result="Shape_3" />
|
||||
</filter>
|
||||
</defs>
|
||||
<g transform="translate(6 2)">
|
||||
<g>
|
||||
<path d="M300 0C465.708 0 600 134.292 600 300C600 300 600 300 600 300C600 465.708 465.708 600 300 600C300 600 300 600 300 600C134.292 600 0 465.708 0 300C0 300 0 300 0 300C0 134.292 134.292 0 300 0Z" fill="#5A00FF" fill-rule="evenodd" />
|
||||
<path d="M300 0C465.708 0 600 134.292 600 300C600 300 600 300 600 300C600 465.708 465.708 600 300 600C300 600 300 600 300 600C134.292 600 0 465.708 0 300C0 300 0 300 0 300C0 134.292 134.292 0 300 0Z" fill="url(#gradient_1)" fill-rule="evenodd" />
|
||||
</g>
|
||||
<path d="M0 110.5C0 49.4725 49.4725 0 110.5 0C171.527 0 221 49.4725 221 110.5C221 171.527 171.527 221 110.5 221C49.4725 221 0 171.527 0 110.5Z" fill="url(#gradient_2)" fill-rule="evenodd" filter="url(#filter_3)" transform="translate(293 324)" />
|
||||
<path d="M0 55.5C0 24.8482 24.8482 0 55.5 0C86.1518 0 111 24.8482 111 55.5C111 86.1518 86.1518 111 55.5 111C24.8482 111 0 86.1518 0 55.5Z" fill="url(#gradient_4)" fill-rule="evenodd" filter="url(#filter_5)" transform="translate(48 269)" />
|
||||
<path d="M0 174C0 77.9024 77.9024 0 174 0C270.098 0 348 77.9024 348 174C348 270.098 270.098 348 174 348C77.9024 348 0 270.098 0 174Z" fill="url(#gradient_6)" fill-rule="evenodd" filter="url(#filter_7)" transform="translate(188 56)" />
|
||||
<path d="M0 57C0 25.5198 25.5198 0 57 0C88.4802 0 114 25.5198 114 57C114 88.4802 88.4802 114 57 114C25.5198 114 0 88.4802 0 57Z" fill="url(#gradient_8)" fill-rule="evenodd" filter="url(#filter_9)" transform="translate(388 129)" />
|
||||
</g>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 5.1 KiB |
BIN
en/images/icons/openmcp-edge.free
Normal file
BIN
en/images/icons/openmcp-edge.free
Normal file
Binary file not shown.
71
en/images/icons/openmcp-edge.svg
Normal file
71
en/images/icons/openmcp-edge.svg
Normal file
@ -0,0 +1,71 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<svg width="612" height="612" viewBox="0 0 612 612" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<defs>
|
||||
<linearGradient id="gradient_1" gradientUnits="userSpaceOnUse" x1="300" y1="0" x2="300" y2="600">
|
||||
<stop offset="0" stop-color="#A1A7F6" />
|
||||
<stop offset="1" stop-color="#FFFFFF" stop-opacity="0.2" />
|
||||
</linearGradient>
|
||||
<linearGradient id="gradient_2" gradientUnits="userSpaceOnUse" x1="110.5" y1="0" x2="110.5" y2="221">
|
||||
<stop offset="0.468" stop-color="#BFBAF6" />
|
||||
<stop offset="1" stop-color="#FFFFFF" />
|
||||
</linearGradient>
|
||||
<filter color-interpolation-filters="sRGB" x="-219" y="-219" width="221" height="221" id="filter_3">
|
||||
<feFlood flood-opacity="0" result="BackgroundImageFix_1" />
|
||||
<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0" in="SourceAlpha" />
|
||||
<feOffset dx="0" dy="4" />
|
||||
<feGaussianBlur stdDeviation="2" />
|
||||
<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.251 0" />
|
||||
<feBlend mode="normal" in2="BackgroundImageFix_1" result="Shadow_2" />
|
||||
<feBlend mode="normal" in="SourceGraphic" in2="Shadow_2" result="Shape_3" />
|
||||
</filter>
|
||||
<linearGradient id="gradient_4" gradientUnits="userSpaceOnUse" x1="55.5" y1="0" x2="55.5" y2="111">
|
||||
<stop offset="0" stop-color="#FFFFFF" />
|
||||
<stop offset="1" stop-color="#A8A7F3" />
|
||||
</linearGradient>
|
||||
<filter color-interpolation-filters="sRGB" x="-109" y="-109" width="111" height="111" id="filter_5">
|
||||
<feFlood flood-opacity="0" result="BackgroundImageFix_1" />
|
||||
<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0" in="SourceAlpha" />
|
||||
<feOffset dx="0" dy="4" />
|
||||
<feGaussianBlur stdDeviation="2" />
|
||||
<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.251 0" />
|
||||
<feBlend mode="normal" in2="BackgroundImageFix_1" result="Shadow_2" />
|
||||
<feBlend mode="normal" in="SourceGraphic" in2="Shadow_2" result="Shape_3" />
|
||||
</filter>
|
||||
<linearGradient id="gradient_6" gradientUnits="userSpaceOnUse" x1="174" y1="0" x2="174" y2="348">
|
||||
<stop offset="0.182" stop-color="#A594F6" />
|
||||
<stop offset="1" stop-color="#F4E5FF" />
|
||||
</linearGradient>
|
||||
<filter color-interpolation-filters="sRGB" x="-346" y="-346" width="348" height="348" id="filter_7">
|
||||
<feFlood flood-opacity="0" result="BackgroundImageFix_1" />
|
||||
<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0" in="SourceAlpha" />
|
||||
<feOffset dx="0" dy="4" />
|
||||
<feGaussianBlur stdDeviation="2" />
|
||||
<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.251 0" />
|
||||
<feBlend mode="normal" in2="BackgroundImageFix_1" result="Shadow_2" />
|
||||
<feBlend mode="normal" in="SourceGraphic" in2="Shadow_2" result="Shape_3" />
|
||||
</filter>
|
||||
<linearGradient id="gradient_8" gradientUnits="userSpaceOnUse" x1="57" y1="0" x2="57" y2="114">
|
||||
<stop offset="0" stop-color="#FFFFFF" />
|
||||
<stop offset="0.614" stop-color="#C7BAF8" />
|
||||
</linearGradient>
|
||||
<filter color-interpolation-filters="sRGB" x="-112" y="-112" width="114" height="114" id="filter_9">
|
||||
<feFlood flood-opacity="0" result="BackgroundImageFix_1" />
|
||||
<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 1 0" in="SourceAlpha" />
|
||||
<feOffset dx="0" dy="4" />
|
||||
<feGaussianBlur stdDeviation="2" />
|
||||
<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.251 0" />
|
||||
<feBlend mode="normal" in2="BackgroundImageFix_1" result="Shadow_2" />
|
||||
<feBlend mode="normal" in="SourceGraphic" in2="Shadow_2" result="Shape_3" />
|
||||
</filter>
|
||||
</defs>
|
||||
<g transform="translate(6 2)">
|
||||
<g>
|
||||
<path d="M300 0C465.708 0 600 134.292 600 300C600 300 600 300 600 300C600 465.708 465.708 600 300 600C300 600 300 600 300 600C134.292 600 0 465.708 0 300C0 300 0 300 0 300C0 134.292 134.292 0 300 0Z" fill="#5A00FF" fill-rule="evenodd" />
|
||||
<path d="M300 0C465.708 0 600 134.292 600 300C600 300 600 300 600 300C600 465.708 465.708 600 300 600C300 600 300 600 300 600C134.292 600 0 465.708 0 300C0 300 0 300 0 300C0 134.292 134.292 0 300 0Z" fill="url(#gradient_1)" fill-rule="evenodd" />
|
||||
</g>
|
||||
<path d="M0 110.5C0 49.4725 49.4725 0 110.5 0C171.527 0 221 49.4725 221 110.5C221 171.527 171.527 221 110.5 221C49.4725 221 0 171.527 0 110.5Z" fill="url(#gradient_2)" fill-rule="evenodd" filter="url(#filter_3)" transform="translate(293 324)" />
|
||||
<path d="M0 55.5C0 24.8482 24.8482 0 55.5 0C86.1518 0 111 24.8482 111 55.5C111 86.1518 86.1518 111 55.5 111C24.8482 111 0 86.1518 0 55.5Z" fill="url(#gradient_4)" fill-rule="evenodd" filter="url(#filter_5)" transform="translate(48 269)" />
|
||||
<path d="M0 174C0 77.9024 77.9024 0 174 0C270.098 0 348 77.9024 348 174C348 270.098 270.098 348 174 348C77.9024 348 0 270.098 0 174Z" fill="url(#gradient_6)" fill-rule="evenodd" filter="url(#filter_7)" transform="translate(188 56)" />
|
||||
<path d="M0 57C0 25.5198 25.5198 0 57 0C88.4802 0 114 25.5198 114 57C114 88.4802 88.4802 114 57 114C25.5198 114 0 88.4802 0 57Z" fill="url(#gradient_8)" fill-rule="evenodd" filter="url(#filter_9)" transform="translate(388 129)" />
|
||||
</g>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 5.1 KiB |
34
en/images/icons/openmcp-sdk.svg
Normal file
34
en/images/icons/openmcp-sdk.svg
Normal file
@ -0,0 +1,34 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<svg width="600" height="674" viewBox="0 0 600 674" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<defs>
|
||||
<linearGradient id="gradient_1" gradientUnits="userSpaceOnUse" x1="300" y1="0" x2="300" y2="600">
|
||||
<stop offset="0" stop-color="#A1A7F6" />
|
||||
<stop offset="1" stop-color="#FFFFFF" stop-opacity="0.2" />
|
||||
</linearGradient>
|
||||
<linearGradient id="gradient_2" gradientUnits="userSpaceOnUse" x1="110.5" y1="0" x2="110.5" y2="221">
|
||||
<stop offset="0.441" stop-color="#A8A3FF" />
|
||||
<stop offset="1" stop-color="#FFFFFF" />
|
||||
</linearGradient>
|
||||
<linearGradient id="gradient_3" gradientUnits="userSpaceOnUse" x1="55.5" y1="0" x2="55.5" y2="111">
|
||||
<stop offset="0" stop-color="#FFFFFF" />
|
||||
<stop offset="1" stop-color="#A489FB" />
|
||||
</linearGradient>
|
||||
<linearGradient id="gradient_5" gradientUnits="userSpaceOnUse" x1="126" y1="0" x2="126" y2="647">
|
||||
<stop offset="0" stop-color="#FFF2B0" />
|
||||
<stop offset="0.461" stop-color="#F2B63A" />
|
||||
</linearGradient>
|
||||
</defs>
|
||||
<g>
|
||||
<g>
|
||||
<g transform="translate(0 74)">
|
||||
<path d="M300 0C465.708 0 600 134.292 600 300C600 300 600 300 600 300C600 465.708 465.708 600 300 600C300 600 300 600 300 600C134.292 600 0 465.708 0 300C0 300 0 300 0 300C0 134.292 134.292 0 300 0Z" fill="#5A00FF" fill-rule="evenodd" />
|
||||
<path d="M300 0C465.708 0 600 134.292 600 300C600 300 600 300 600 300C600 465.708 465.708 600 300 600C300 600 300 600 300 600C134.292 600 0 465.708 0 300C0 300 0 300 0 300C0 134.292 134.292 0 300 0Z" fill="url(#gradient_1)" fill-rule="evenodd" />
|
||||
</g>
|
||||
<path d="M0 110.5C0 49.4725 49.4725 0 110.5 0C171.527 0 221 49.4725 221 110.5C221 171.527 171.527 221 110.5 221C49.4725 221 0 171.527 0 110.5Z" fill="url(#gradient_2)" fill-rule="evenodd" transform="translate(284 417)" />
|
||||
<path d="M0 55.5C0 24.8482 24.8482 0 55.5 0C86.1518 0 111 24.8482 111 55.5C111 86.1518 86.1518 111 55.5 111C24.8482 111 0 86.1518 0 55.5Z" fill="url(#gradient_3)" fill-rule="evenodd" transform="translate(49 374)" />
|
||||
<path d="M0 182.5C0 81.708 81.708 0 182.5 0C283.292 0 365 81.708 365 182.5C365 283.292 283.292 365 182.5 365C81.708 365 0 283.292 0 182.5Z" fill="url(#gradient_4)" fill-rule="evenodd" transform="translate(179 108)" />
|
||||
<path d="M215.354 294.309L24.8044 647C24.8044 647 80.3091 362.484 80.3091 362.484C80.9377 359.199 79.5325 355.85 77.4987 355.85C77.4987 355.85 23.6951 355.85 23.6951 355.85C6.50011 355.85 -4.96321 325.459 2.13664 298.669C2.13664 298.669 75.28 23.6938 75.28 23.6938C79.1258 9.28799 87.5569 0 96.8384 0C96.8384 0 252 0 252 0C252 0 178.82 218.868 178.82 218.868C177.71 222.217 179.115 226.45 181.371 226.45C181.371 226.45 197.938 226.45 197.938 226.45C218.571 226.45 229.332 268.404 215.354 294.309C215.354 294.309 215.354 294.309 215.354 294.309Z" fill="url(#gradient_5)" transform="translate(193 0)" />
|
||||
</g>
|
||||
<rect width="432" height="432" transform="translate(84 107)" />
|
||||
</g>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 2.9 KiB |
21
en/images/icons/openmcp.svg
Normal file
21
en/images/icons/openmcp.svg
Normal file
@ -0,0 +1,21 @@
|
||||
<?xml version="1.0" encoding="utf-8"?>
|
||||
<svg width="100%" height="100%" viewBox="0 0 824 834" preserveAspectRatio="xMidYMid meet" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<defs>
|
||||
<linearGradient id="gradient_1" gradientUnits="userSpaceOnUse" x1="300" y1="0" x2="300" y2="600">
|
||||
<stop offset="0" stop-color="#A1A7F6" />
|
||||
<stop offset="1" stop-color="#FFFFFF" stop-opacity="0.2" />
|
||||
</linearGradient>
|
||||
</defs>
|
||||
<g>
|
||||
<g transform="translate(145 58)">
|
||||
<g>
|
||||
<path d="M300 0C465.708 0 600 134.292 600 300C600 300 600 300 600 300C600 465.708 465.708 600 300 600C300 600 300 600 300 600C134.292 600 0 465.708 0 300C0 300 0 300 0 300C0 134.292 134.292 0 300 0Z" fill="#5A00FF" fill-rule="evenodd" />
|
||||
<path d="M300 0C465.708 0 600 134.292 600 300C600 300 600 300 600 300C600 465.708 465.708 600 300 600C300 600 300 600 300 600C134.292 600 0 465.708 0 300C0 300 0 300 0 300C0 134.292 134.292 0 300 0Z" fill="url(#gradient_1)" fill-rule="evenodd" />
|
||||
</g>
|
||||
<path d="M0 110.5C0 49.4725 49.4725 0 110.5 0C171.527 0 221 49.4725 221 110.5C221 171.527 171.527 221 110.5 221C49.4725 221 0 171.527 0 110.5Z" fill="#FFFFFF" fill-rule="evenodd" transform="translate(294 341)" />
|
||||
<path d="M0 55.5C0 24.8482 24.8482 0 55.5 0C86.1518 0 111 24.8482 111 55.5C111 86.1518 86.1518 111 55.5 111C24.8482 111 0 86.1518 0 55.5Z" fill="#FFFFFF" fill-rule="evenodd" transform="translate(48 269)" />
|
||||
<path d="M0 182.5C0 81.708 81.708 0 182.5 0C283.292 0 365 81.708 365 182.5C365 283.292 283.292 365 182.5 365C81.708 365 0 283.292 0 182.5Z" fill="#FFFFFF" fill-rule="evenodd" transform="translate(188 39)" />
|
||||
<path d="M0 57C0 25.5198 25.5198 0 57 0C88.4802 0 114 25.5198 114 57C114 88.4802 88.4802 114 57 114C25.5198 114 0 88.4802 0 57Z" fill="#FFFFFF" fill-rule="evenodd" transform="translate(376 130)" />
|
||||
</g>
|
||||
</g>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 1.8 KiB |
41
en/images/icons/vscode.svg
Normal file
41
en/images/icons/vscode.svg
Normal file
@ -0,0 +1,41 @@
|
||||
<svg width="100" height="100" viewBox="0 0 100 100" fill="none" xmlns="http://www.w3.org/2000/svg">
|
||||
<mask id="mask0" mask-type="alpha" maskUnits="userSpaceOnUse" x="0" y="0" width="100" height="100">
|
||||
<path fill-rule="evenodd" clip-rule="evenodd" d="M70.9119 99.3171C72.4869 99.9307 74.2828 99.8914 75.8725 99.1264L96.4608 89.2197C98.6242 88.1787 100 85.9892 100 83.5872V16.4133C100 14.0113 98.6243 11.8218 96.4609 10.7808L75.8725 0.873756C73.7862 -0.130129 71.3446 0.11576 69.5135 1.44695C69.252 1.63711 69.0028 1.84943 68.769 2.08341L29.3551 38.0415L12.1872 25.0096C10.589 23.7965 8.35363 23.8959 6.86933 25.2461L1.36303 30.2549C-0.452552 31.9064 -0.454633 34.7627 1.35853 36.417L16.2471 50.0001L1.35853 63.5832C-0.454633 65.2374 -0.452552 68.0938 1.36303 69.7453L6.86933 74.7541C8.35363 76.1043 10.589 76.2037 12.1872 74.9905L29.3551 61.9587L68.769 97.9167C69.3925 98.5406 70.1246 99.0104 70.9119 99.3171ZM75.0152 27.2989L45.1091 50.0001L75.0152 72.7012V27.2989Z" fill="white"/>
|
||||
</mask>
|
||||
<g mask="url(#mask0)">
|
||||
<path d="M96.4614 10.7962L75.8569 0.875542C73.4719 -0.272773 70.6217 0.211611 68.75 2.08333L1.29858 63.5832C-0.515693 65.2373 -0.513607 68.0937 1.30308 69.7452L6.81272 74.754C8.29793 76.1042 10.5347 76.2036 12.1338 74.9905L93.3609 13.3699C96.086 11.3026 100 13.2462 100 16.6667V16.4275C100 14.0265 98.6246 11.8378 96.4614 10.7962Z" fill="#0065A9"/>
|
||||
<g filter="url(#filter0_d)">
|
||||
<path d="M96.4614 89.2038L75.8569 99.1245C73.4719 100.273 70.6217 99.7884 68.75 97.9167L1.29858 36.4169C-0.515693 34.7627 -0.513607 31.9063 1.30308 30.2548L6.81272 25.246C8.29793 23.8958 10.5347 23.7964 12.1338 25.0095L93.3609 86.6301C96.086 88.6974 100 86.7538 100 83.3334V83.5726C100 85.9735 98.6246 88.1622 96.4614 89.2038Z" fill="#007ACC"/>
|
||||
</g>
|
||||
<g filter="url(#filter1_d)">
|
||||
<path d="M75.8578 99.1263C73.4721 100.274 70.6219 99.7885 68.75 97.9166C71.0564 100.223 75 98.5895 75 95.3278V4.67213C75 1.41039 71.0564 -0.223106 68.75 2.08329C70.6219 0.211402 73.4721 -0.273666 75.8578 0.873633L96.4587 10.7807C98.6234 11.8217 100 14.0112 100 16.4132V83.5871C100 85.9891 98.6234 88.1786 96.4586 89.2196L75.8578 99.1263Z" fill="#1F9CF0"/>
|
||||
</g>
|
||||
<g style="mix-blend-mode:overlay" opacity="0.25">
|
||||
<path fill-rule="evenodd" clip-rule="evenodd" d="M70.8511 99.3171C72.4261 99.9306 74.2221 99.8913 75.8117 99.1264L96.4 89.2197C98.5634 88.1787 99.9392 85.9892 99.9392 83.5871V16.4133C99.9392 14.0112 98.5635 11.8217 96.4001 10.7807L75.8117 0.873695C73.7255 -0.13019 71.2838 0.115699 69.4527 1.44688C69.1912 1.63705 68.942 1.84937 68.7082 2.08335L29.2943 38.0414L12.1264 25.0096C10.5283 23.7964 8.29285 23.8959 6.80855 25.246L1.30225 30.2548C-0.513334 31.9064 -0.515415 34.7627 1.29775 36.4169L16.1863 50L1.29775 63.5832C-0.515415 65.2374 -0.513334 68.0937 1.30225 69.7452L6.80855 74.754C8.29285 76.1042 10.5283 76.2036 12.1264 74.9905L29.2943 61.9586L68.7082 97.9167C69.3317 98.5405 70.0638 99.0104 70.8511 99.3171ZM74.9544 27.2989L45.0483 50L74.9544 72.7012V27.2989Z" fill="url(#paint0_linear)"/>
|
||||
</g>
|
||||
</g>
|
||||
<defs>
|
||||
<filter id="filter0_d" x="-8.39411" y="15.8291" width="116.727" height="92.2456" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
|
||||
<feFlood flood-opacity="0" result="BackgroundImageFix"/>
|
||||
<feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/>
|
||||
<feOffset/>
|
||||
<feGaussianBlur stdDeviation="4.16667"/>
|
||||
<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0"/>
|
||||
<feBlend mode="overlay" in2="BackgroundImageFix" result="effect1_dropShadow"/>
|
||||
<feBlend mode="normal" in="SourceGraphic" in2="effect1_dropShadow" result="shape"/>
|
||||
</filter>
|
||||
<filter id="filter1_d" x="60.4167" y="-8.07558" width="47.9167" height="116.151" filterUnits="userSpaceOnUse" color-interpolation-filters="sRGB">
|
||||
<feFlood flood-opacity="0" result="BackgroundImageFix"/>
|
||||
<feColorMatrix in="SourceAlpha" type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 127 0"/>
|
||||
<feOffset/>
|
||||
<feGaussianBlur stdDeviation="4.16667"/>
|
||||
<feColorMatrix type="matrix" values="0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0 0.25 0"/>
|
||||
<feBlend mode="overlay" in2="BackgroundImageFix" result="effect1_dropShadow"/>
|
||||
<feBlend mode="normal" in="SourceGraphic" in2="effect1_dropShadow" result="shape"/>
|
||||
</filter>
|
||||
<linearGradient id="paint0_linear" x1="49.9392" y1="0.257812" x2="49.9392" y2="99.7423" gradientUnits="userSpaceOnUse">
|
||||
<stop stop-color="white"/>
|
||||
<stop offset="1" stop-color="white" stop-opacity="0"/>
|
||||
</linearGradient>
|
||||
</defs>
|
||||
</svg>
|
||||
|
After Width: | Height: | Size: 4.3 KiB |
BIN
en/images/openmcp-default.png
Normal file
BIN
en/images/openmcp-default.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 31 KiB |
BIN
en/images/openmcp.chatbot.png
Normal file
BIN
en/images/openmcp.chatbot.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 543 KiB |
BIN
en/images/openmcp.png
Normal file
BIN
en/images/openmcp.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 62 KiB |
BIN
en/images/opensource.png
Normal file
BIN
en/images/opensource.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 1.3 MiB |
BIN
en/images/public-deploy.png
Normal file
BIN
en/images/public-deploy.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 431 KiB |
128
en/index.md
Normal file
128
en/index.md
Normal file
@ -0,0 +1,128 @@
|
||||
---
|
||||
# https://vitepress.dev/reference/default-theme-home-page
|
||||
layout: home
|
||||
|
||||
hero:
|
||||
name: "OpenMCP"
|
||||
text: "MCP Debugger and SDK for Elegant Developers"
|
||||
tagline: Bridge the last mile from large language models to intelligent agents
|
||||
|
||||
actions:
|
||||
- theme: brand
|
||||
text: OpenMCP Plugin
|
||||
link: ./plugin-tutorial
|
||||
- theme: alt
|
||||
text: openmcp-sdk
|
||||
link: ./sdk-tutorial
|
||||
- theme: alt
|
||||
text: GitHub
|
||||
link: https://github.com/LSTM-Kirigaya/openmcp-client
|
||||
features:
|
||||
- icon:
|
||||
src: /images/icons/vscode.svg
|
||||
height: 48px
|
||||
alt: Integrated Debugging Environment
|
||||
title: Integrated Debugging Environment
|
||||
details: Combine the inspector with MCP client functions to achieve seamless development and testing
|
||||
- icon:
|
||||
src: /images/icons/openmcp-edge.svg
|
||||
height: 48px
|
||||
alt: Provide a complete project-level control panel
|
||||
title: Comprehensive Project Management
|
||||
details: Provide a complete project-level control panel for efficient MCP project supervision
|
||||
- icon:
|
||||
src: /images/icons/openmcp-sdk.svg
|
||||
height: 48px
|
||||
alt: Provide a complete project-level control panel
|
||||
title: Complete Deployment Solution
|
||||
details: Deploy tested agents to your application or server via openmcp-sdk
|
||||
---
|
||||
|
||||
<br><br>
|
||||
|
||||
<h2 id="home-0">
|
||||
Resolve Issues in Your MCP Agent Development
|
||||
<br>
|
||||
<span>Providing Fun and Convenience for Your MCP Agent Development</span>
|
||||
</h2>
|
||||
|
||||
<BiliPlayer
|
||||
url="//player.bilibili.com/player.html?isOutside=true&aid=114445745397200&bvid=BV1zYGozgEHcautoplay=false"
|
||||
cover="https://picx.zhimg.com/80/v2-8c1f5d99066ed272554146ed8caf7cc3_1440w.png"
|
||||
/>
|
||||
|
||||
<br>
|
||||
|
||||
<h2 id="home-1">
|
||||
Who is OpenMCP for?
|
||||
<br>
|
||||
<span>The Development of OpenMCP is for ...</span>
|
||||
</h2>
|
||||
|
||||
<br>
|
||||
|
||||
<KTab class="home-tab">
|
||||
<TwoSideLayout
|
||||
label="Professional Software Engineers"
|
||||
:texts="[
|
||||
'Shift testing left to integrate your development and testing without opening third - party software. It offers extremely rich features.',
|
||||
'Manage, debug, and test your intelligent agents freely and elegantly on the left - hand panel.',
|
||||
'Every detail of the large language model calling tool is visible at a glance. You can directly reproduce unsatisfactory calling results with one click.',
|
||||
'Each conversation will display various performance indicators, facilitating cost management.',
|
||||
'The system prompt management panel allows you to easily build your intelligent agent applications with MCP servers and system prompts.'
|
||||
]"
|
||||
image="./images/openmcp.chatbot.png"
|
||||
/>
|
||||
<TwoSideLayout
|
||||
label="Open - Source Community Enthusiasts"
|
||||
:texts="[
|
||||
'Shift testing left to integrate your development and testing without opening third - party software. It offers extremely rich features.',
|
||||
'OpenMCP is completely open - source. You can not only try this product for free but also join us to realize your creative ideas about agents.',
|
||||
'The technical details are fully disclosed. You don\'t have to worry about your ideas and tokens being plagiarized.',
|
||||
'The persistent system prompt management panel enables you to test the system prompts of actual MCP servers for sharing within the community.',
|
||||
'The details of each test will be 100% under Git version control, making it easy for you to share your test results and reproduce others\' MCP projects at zero cost.'
|
||||
]"
|
||||
image="./images/opensource.png"
|
||||
/>
|
||||
<TwoSideLayout
|
||||
label="AI Research Scientists"
|
||||
:texts="[
|
||||
'Shift testing left to integrate your development and testing without opening third - party software. It offers extremely rich features.',
|
||||
'With just a few lines of code, you can quickly turn your scientific research results into MCP servers and connect to any large language model to achieve a user - friendly interface.',
|
||||
'All experimental data and configuration parameters are automatically included in the Git version management system, ensuring that research results are traceable and reproducible for academic exchanges and paper reproduction.',
|
||||
'Based on OpenMCP, you can quickly complete your demo and shorten the distance from innovation to implementation.'
|
||||
]"
|
||||
image="./images/openmcp.chatbot.png"
|
||||
/>
|
||||
</KTab>
|
||||
|
||||
<br>
|
||||
|
||||
<h2 id="home-2">
|
||||
FAQ
|
||||
<br>
|
||||
<span>Waiting for Your Questions</span>
|
||||
</h2>
|
||||
|
||||
<el-collapse>
|
||||
<el-collapse-item title="What is OpenMCP suitable for?" name="1">
|
||||
As its name suggests, OpenMCP is an MCP debugger and SDK for developers, committed to reducing the full - chain development cost of AI agents and the mental burden of developers. Our mission is to create MCP tools that can solve real - life problems and save working time through OpenMCP, or help engineers and research scientists deliver demos more quickly and make this vision visible to the public.
|
||||
</el-collapse-item>
|
||||
<el-collapse-item title="Is OpenMCP free?" name="2">
|
||||
Yes, OpenMCP is completely open - source. You can not only use this product for free but also join us to realize your creative ideas about agents. The task of OpenMCP is to build an ecosystem around MCP. We believe that MCP development will be a highly customized task in the future, so our current focus is not to rush to create an all - purpose agent, but to steadily build the relevant ecosystem and infrastructure.
|
||||
</el-collapse-item>
|
||||
<el-collapse-item title="What is OpenMCP not suitable for?" name="3">
|
||||
If you try to develop an all - purpose, general AI agent through OpenMCP, you should invest all your money in the research and development of quantum computers instead of visiting this website. Remember, in this era, developing a full - domain general AI agent is likely to be equivalent to telecom fraud.
|
||||
</el-collapse-item>
|
||||
<el-collapse-item title="Who is developing OpenMCP?" name="4">
|
||||
<p>OpenMCP was initially led by LSTM - Kirigaya (Jinhui) for building MCP testing tools related to 3D work. Its main participants include employees from large companies, students majoring in computer - related fields at universities, and some active contributors from the open - source community.</p>
|
||||
<p>Identity is not important. I'd like to share a quote with you: "Don't tell me if you can do it. Tell me if you like it."</p>
|
||||
<img src="https://pica.zhimg.com/80/v2-3666e84b2f92bf444a5eb64fb9d08e71_1440w.png" style="max-width: 500px;margin-top:10px;"/>
|
||||
</el-collapse-item>
|
||||
<el-collapse-item title="How can I join you or participate in discussions?" name="5">
|
||||
You can learn how to participate in the maintenance and development of OpenMCP through <a href="https://kirigaya.cn/openmcp/preview/join.html" target="_blank">Participate in OpenMCP</a>. Obtain our contact information through <a href="https://kirigaya.cn/openmcp/preview/channel.html" target="_blank">Resource Channel</a>. Currently, there are three main communities: QQ group: 782833642, <a href="https://discord.com/invite/SKTZRf6NzU" target="_blank">OpenMCP Discord Channel</a>, and <a href="https://www.zhihu.com/ring/host/1911121615279849840" target="_blank">Zhihu Circle [OpenMCP Museum]</a>
|
||||
</el-collapse-item>
|
||||
<el-collapse-item title="How to contact us for cooperation?" name="6">
|
||||
For cooperation, please contact Jinhui's personal email: 1193466151@qq.com
|
||||
</el-collapse-item>
|
||||
</el-collapse>
|
||||
232
en/plugin-tutorial/concept.md
Normal file
232
en/plugin-tutorial/concept.md
Normal file
@ -0,0 +1,232 @@
|
||||
# MCP 基础概念
|
||||
|
||||
## 前言
|
||||
|
||||
|
||||
|
||||
在 [[what-is-mcp|之前的文章]] 中，我们简单介绍了 MCP 的定义和它的基本组织结构。作为开发者，我们最需要关注的其实是如何根据我们自己的业务和场景定制化地开发我们需要的 MCP 服务器，这样直接接入任何一个 MCP 客户端后，我们都可以给大模型以我们定制出的交互能力。
|
||||
|
||||
在正式开始教大家如何开发自己的 MCP 服务器之前，我想，或许有必要讲清楚几个基本概念。
|
||||
|
||||
## Resources, Prompts 和 Tools
|
||||
|
||||
在 [MCP 客户端协议](https://modelcontextprotocol.io/clients) 中，讲到了 MCP 协议中三个非常重要的能力类别：
|
||||
|
||||
- Resouces ：定制化地请求和访问本地的资源，可以是文件系统、数据库、当前代码编辑器中的文件等等原本网页端的app 无法访问到的 **静态资源**。额外的 resources 会丰富发送给大模型的上下文，使得 AI 给我们更加精准的回答。
|
||||
- Prompts ：定制化一些场景下可供 AI 进行采纳的 prompt，比如如果需要 AI 定制化地返回某些格式化内容时，可以提供自定义的 prompts。
|
||||
- Tools ：可供 AI 使用的工具，它必须是一个函数，比如预定酒店、打开网页、关闭台灯这些封装好的函数就可以是一个 tool，大模型会通过 function calling 的方式来使用这些 tools。 Tools 将会允许 AI 直接操作我们的电脑，甚至和现实世界发生交互。
|
||||
|
||||
各位拥有前后端开发经验的朋友们，可以将 Resouces 看成是「额外给予大模型的只读权限」，把 Tools 看成是「额外给予大模型的读写权限」。
|
||||
|
||||
MCP 客户端（比如 Claude Desktop，5ire 等）已经实现好了上述的前端部分逻辑。而具体提供什么资源，具体提供什么工具，则需要各位玩家充分想象了，也就是我们需要开发丰富多彩的 MCP Server 来允许大模型做出更多有意思的工作。
|
||||
|
||||
不过需要说明的一点是，目前几乎所有大模型采用了 openai 协议作为我们访问大模型的接入点。什么叫 openai 协议呢？
|
||||
|
||||
## openai 协议
|
||||
|
||||
当我们使用 python 或者 typescript 开发 app 时，往往会安装一个名为 openai 的库，里面填入你需要使用的模型厂商、模型的基础 url、使用的模型类别来直接访问大模型。而各个大模型提供商也必须支持这个库，这套协议。
|
||||
|
||||
比如我们在 python 中访问 deepseek 的服务就可以这么做：
|
||||
|
||||
```python
|
||||
from openai import OpenAI
|
||||
|
||||
client = OpenAI(api_key="<DeepSeek API Key>", base_url="https://api.deepseek.com")
|
||||
|
||||
response = client.chat.completions.create(
|
||||
model="deepseek-chat",
|
||||
messages=[
|
||||
{"role": "system", "content": "You are a helpful assistant"},
|
||||
{"role": "user", "content": "Hello"},
|
||||
],
|
||||
stream=False
|
||||
)
|
||||
|
||||
print(response.choices[0].message.content)
|
||||
```
|
||||
|
||||
如果你点进这个 create 函数去看，你会发现 openai 协议需要大模型厂家支持的 feature 是非常非常多的：
|
||||
|
||||
```python
|
||||
@overload
|
||||
def create(
|
||||
self,
|
||||
*,
|
||||
messages: Iterable[ChatCompletionMessageParam],
|
||||
model: Union[str, ChatModel],
|
||||
audio: Optional[ChatCompletionAudioParam] | NotGiven = NOT_GIVEN,
|
||||
frequency_penalty: Optional[float] | NotGiven = NOT_GIVEN,
|
||||
function_call: completion_create_params.FunctionCall | NotGiven = NOT_GIVEN,
|
||||
functions: Iterable[completion_create_params.Function] | NotGiven = NOT_GIVEN,
|
||||
logit_bias: Optional[Dict[str, int]] | NotGiven = NOT_GIVEN,
|
||||
logprobs: Optional[bool] | NotGiven = NOT_GIVEN,
|
||||
max_completion_tokens: Optional[int] | NotGiven = NOT_GIVEN,
|
||||
max_tokens: Optional[int] | NotGiven = NOT_GIVEN,
|
||||
metadata: Optional[Metadata] | NotGiven = NOT_GIVEN,
|
||||
modalities: Optional[List[Literal["text", "audio"]]] | NotGiven = NOT_GIVEN,
|
||||
n: Optional[int] | NotGiven = NOT_GIVEN,
|
||||
parallel_tool_calls: bool | NotGiven = NOT_GIVEN,
|
||||
prediction: Optional[ChatCompletionPredictionContentParam] | NotGiven = NOT_GIVEN,
|
||||
presence_penalty: Optional[float] | NotGiven = NOT_GIVEN,
|
||||
reasoning_effort: Optional[ReasoningEffort] | NotGiven = NOT_GIVEN,
|
||||
response_format: completion_create_params.ResponseFormat | NotGiven = NOT_GIVEN,
|
||||
seed: Optional[int] | NotGiven = NOT_GIVEN,
|
||||
service_tier: Optional[Literal["auto", "default"]] | NotGiven = NOT_GIVEN,
|
||||
stop: Union[Optional[str], List[str], None] | NotGiven = NOT_GIVEN,
|
||||
store: Optional[bool] | NotGiven = NOT_GIVEN,
|
||||
stream: Optional[Literal[False]] | NotGiven = NOT_GIVEN,
|
||||
stream_options: Optional[ChatCompletionStreamOptionsParam] | NotGiven = NOT_GIVEN,
|
||||
temperature: Optional[float] | NotGiven = NOT_GIVEN,
|
||||
tool_choice: ChatCompletionToolChoiceOptionParam | NotGiven = NOT_GIVEN,
|
||||
tools: Iterable[ChatCompletionToolParam] | NotGiven = NOT_GIVEN,
|
||||
top_logprobs: Optional[int] | NotGiven = NOT_GIVEN,
|
||||
top_p: Optional[float] | NotGiven = NOT_GIVEN,
|
||||
user: str | NotGiven = NOT_GIVEN,
|
||||
web_search_options: completion_create_params.WebSearchOptions | NotGiven = NOT_GIVEN,
|
||||
# Use the following arguments if you need to pass additional parameters to the API that aren't available via kwargs.
|
||||
# The extra values given here take precedence over values defined on the client or passed to this method.
|
||||
extra_headers: Headers | None = None,
|
||||
extra_query: Query | None = None,
|
||||
extra_body: Body | None = None,
|
||||
timeout: float | httpx.Timeout | None | NotGiven = NOT_GIVEN,
|
||||
) -> ChatCompletion:
|
||||
```
|
||||
|
||||
从上面的签名中，你应该可以看到几个很熟悉的参数，比如 `temperature`, `top_p`，很多的大模型使用软件中，有的会给你暴露这个参数进行调节。比如在 5ire 中，内容随机度就是 `temperature` 这个参数的图形化显示。
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-9f8544aa917e8c128fc194adeb7161cd_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
其实如你所见，一次普普通通调用涉及到的可调控参数是非常之多的。而在所有参数中，你可以注意到一个参数叫做 `tools`:
|
||||
|
||||
```python
|
||||
@overload
|
||||
def create(
|
||||
self,
|
||||
*,
|
||||
messages: Iterable[ChatCompletionMessageParam],
|
||||
model: Union[str, ChatModel],
|
||||
audio: Optional[ChatCompletionAudioParam] | NotGiven = NOT_GIVEN,
|
||||
|
||||
# 看这里
|
||||
tools: Iterable[ChatCompletionToolParam] | NotGiven = NOT_GIVEN,
|
||||
) -> ChatCompletion:
|
||||
```
|
||||
|
||||
## tool_calls 字段
|
||||
|
||||
在上面的 openai 协议中，有一个名为 tools 的参数。 tools 就是要求大模型厂商必须支持 function calling 这个特性，也就是我们提供一部分工具的描述（和 MCP 协议完全兼容的），在 tools 不为空的情况下，chat 函数返回的值中会包含一个特殊的字段 `tool_calls`，我们可以运行下面的我写好的让大模型调用可以查询天气的代码：
|
||||
|
||||
```python
|
||||
from openai import OpenAI
|
||||
|
||||
client = OpenAI(
|
||||
api_key="Deepseek API",
|
||||
base_url="https://api.deepseek.com"
|
||||
)
|
||||
|
||||
# 定义 tools（函数/工具列表）
|
||||
tools = [
|
||||
{
|
||||
"type": "function",
|
||||
"function": {
|
||||
"name": "get_current_weather",
|
||||
"description": "获取给定地点的天气",
|
||||
"parameters": {
|
||||
"type": "object",
|
||||
"properties": {
|
||||
"location": {
|
||||
"type": "string",
|
||||
"description": "城市，比如杭州，北京，上海",
|
||||
}
|
||||
},
|
||||
"required": ["location"],
|
||||
},
|
||||
},
|
||||
}
|
||||
]
|
||||
|
||||
response = client.chat.completions.create(
|
||||
model="deepseek-chat",
|
||||
messages=[
|
||||
{"role": "system", "content": "你是一个很有用的 AI"},
|
||||
{"role": "user", "content": "今天杭州的天气是什么？"},
|
||||
],
|
||||
tools=tools, # 传入 tools 参数
|
||||
tool_choice="auto", # 可选：控制是否强制调用某个工具
|
||||
stream=False,
|
||||
)
|
||||
|
||||
print(response.choices[0].message)
|
||||
```
|
||||
|
||||
运行上述代码，它的返回如下：
|
||||
|
||||
```python
|
||||
ChatCompletionMessage(
|
||||
content='',
|
||||
refusal=None,
|
||||
role='assistant',
|
||||
annotations=None,
|
||||
audio=None,
|
||||
function_call=None,
|
||||
tool_calls=[
|
||||
ChatCompletionMessageToolCall(
|
||||
id='call_0_baeaba2b-739d-40c2-aa6c-1e61c6d7e855',
|
||||
function=Function(
|
||||
arguments='{"location":"杭州"}',
|
||||
name='get_current_weather'
|
||||
),
|
||||
type='function',
|
||||
index=0
|
||||
)
|
||||
]
|
||||
)
|
||||
```
|
||||
|
||||
可以看到上面的 `tool_calls` 给出了大模型想要如何去使用我们给出的工具。需要说明的一点是，收到上下文的限制，目前一个问题能够让大模型调取的工具上限一般不会超过 100 个，这个和大模型厂商的上下文大小有关系。奥，对了，友情提示，当你使用 MCP 客户端在使用大模型解决问题时，同一时间激活的 MCP Server 越多，消耗的 token 越多哦 :D
|
||||
|
||||
而目前 openai 的协议中，tools 是只支持函数类的调用。而函数类的调用往往是可以模拟出 Resources 的效果的。比如取资源，你可以描述为一个 tool。因此在正常情况下，如果大家要开发 MCP Server，最好只开发 Tools，另外两个 feature 还暂时没有得到广泛支持。
|
||||
|
||||
|
||||
|
||||
## 使用 Inspector 进行调试
|
||||
|
||||
Claude 原生提供的 MCP 协议可以通过官方提供的 Inspector 进行调试，对于 [[first-mcp|你的第一个 MCP]] 中的例子，可以如下进行调试，在命令行输入如下命令启动 Inspector:
|
||||
|
||||
```bash
|
||||
mcp dev main.py
|
||||
```
|
||||
|
||||
这会启动一个前端服务器，并打开 `http://localhost:5173/` 后我们可以看到 inspector 的调试界面，先点击左侧的 `Connect` 来运行我们的 server.py 并通过 stdio 为通信管道和 web 建立通信。
|
||||
|
||||
Fine，可以开始愉快地进行调试了，Inspector 主要给了我们三个板块，分别对应 Resources，Prompts 和 Tools。
|
||||
|
||||
先来看 Resources，点击「Resource Templates」可以罗列所有注册的 Resource，比如我们上文定义的 `get_greeting`，你可以通过输入参数运行来查看这个函数是否正常工作。（因为一般情况下的这个资源协议是会访问远程数据库或者微服务的）
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-71fc1ad813cdbf7ecec24d878c343b96_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
Prompts 端就比较简单了，直接输入预定义参数就能获取正常的返回结果。
|
||||
|
||||
<div align=center>
|
||||
<img src="https://pic1.zhimg.com/80/v2-4f42899ba1163922ac2347f7cebe5362_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
Tools 端将会是我们后面调试的核心。在之前的章节我们讲过了，MCP 协议中的 Prompts 和 Resources 目前还没有被 openai 协议和各大 MCP 客户端广泛支持，因此，我们主要的服务端业务都应该是在写 tools。
|
||||
|
||||
我们此处提供的 tool 是实现一个简单的加法，它非常简单，我们输入 1 和 2 就可以直接看到结果是 3。我们后续会开发一个可以访问天气预报的 tool，那么到时候就非常需要一个这样的窗口来调试我们的天气信息获取是否正常了。
|
||||
|
||||
<div align=center>
|
||||
<img src="https://pic1.zhimg.com/80/v2-4164a900198a70a158ae441f9e441d07_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
|
||||
|
||||
## 结语
|
||||
|
||||
这篇文章，我们简单了解了 MCP 内部的一些基本概念，我认为这些概念对于诸位开发一个 MCP 服务器是大有裨益的，所以我认为有必要先讲一讲。
|
||||
|
||||
下面的文章中，我将带领大家探索 MCP 的奇境，一个属于 AI Agent 的时代快要到来了。
|
||||
488
en/plugin-tutorial/examples/go-neo4j-sse.md
Normal file
488
en/plugin-tutorial/examples/go-neo4j-sse.md
Normal file
@ -0,0 +1,488 @@
|
||||
# go 实现 neo4j 的只读 mcp 服务器 (SSE)
|
||||
|
||||
[本期教程视频](https://www.bilibili.com/video/BV1g8TozyEE7/)
|
||||
|
||||
## 前言
|
||||
|
||||
本篇教程，演示一下如何使用 go 语言写一个可以访问 neo4j 数据库的 mcp 服务器。实现完成后，我们不需要写任何 查询代码 就能通过询问大模型了解服务器近况。
|
||||
|
||||
不同于之前的连接方式，这次，我们将采用 SSE 的方式来完成服务器的创建和连接。
|
||||
|
||||
本期教程的代码：https://github.com/LSTM-Kirigaya/openmcp-tutorial/tree/main/neo4j-go-server
|
||||
|
||||
建议下载本期的代码，因为里面有我为大家准备好的数据库文件。要不然，你们得自己 mock 数据了。
|
||||
|
||||
|
||||
|
||||
## 1. 准备
|
||||
|
||||
项目结构如下：
|
||||
|
||||
```bash
|
||||
📦neo4j-go-server
|
||||
┣ 📂util
|
||||
┃ ┗ 📜util.go # 工具函数
|
||||
┣ 📜main.go # 主函数
|
||||
┗ 📜neo4j.json # 数据库连接的账号密码
|
||||
```
|
||||
|
||||
我们先创建一个 go 项目：
|
||||
|
||||
```bash
|
||||
mkdir neo4j-go-server
|
||||
cd neo4j-go-server
|
||||
go mod init neo4j-go-server
|
||||
```
|
||||
|
||||
|
||||
|
||||
## 2. 完成数据库初始化
|
||||
|
||||
### 2.1 安装 neo4j
|
||||
|
||||
首先，根据我的教程在本地或者服务器配置一个 neo4j 数据库，这里是是教程，你只需要完成该教程的前两步即可： [neo4j 数据库安装与配置](https://kirigaya.cn/blog/article?seq=199)。将 bin 路径加入环境变量，并且设置的密码设置为 openmcp。
|
||||
|
||||
然后在 main.go 同级下创建 neo4j.json，填写 neo4j 数据库的连接信息：
|
||||
|
||||
```json
|
||||
{
|
||||
"url" : "neo4j://localhost:7687",
|
||||
"name" : "neo4j",
|
||||
"password" : "openmcp"
|
||||
}
|
||||
```
|
||||
|
||||
### 2.2 导入事先准备好的数据
|
||||
|
||||
安装完成后，大家可以导入我实现准备好的数据，这些数据是我的个人网站上部分数据脱敏后的摘要，大家可以随便使用，下载链接：[neo4j.db](https://github.com/LSTM-Kirigaya/openmcp-tutorial/releases/download/neo4j.db/neo4j.db)。下载完成后，运行下面的命令：
|
||||
|
||||
```bash
|
||||
neo4j stop
|
||||
neo4j-admin load --database neo4j --from neo4j.db --force
|
||||
neo4j start
|
||||
```
|
||||
|
||||
然后，我们登录数据库就能看到我准备好的数据啦：
|
||||
|
||||
```bash
|
||||
cypher-shell -a localhost -u neo4j -p openmcp
|
||||
```
|
||||
|
||||
<div align=center>
|
||||
<img src="https://pic1.zhimg.com/80/v2-4b53ad6a355c05d99c7ed18687ced717_1440w.png" style="width: 80%;"/>
|
||||
</div>
|
||||
|
||||
### 2.3 验证 go -> 数据库连通性
|
||||
|
||||
为了验证数据库的连通性和 go 的数据库驱动是否正常工作，我们需要先写一段数据库访问的最小系统。
|
||||
|
||||
先安装 neo4j 的 v5 版本的 go 驱动：
|
||||
|
||||
```bash
|
||||
go get github.com/neo4j/neo4j-go-driver/v5
|
||||
```
|
||||
|
||||
在 `util.go` 中添加以下代码：
|
||||
|
||||
```go
|
||||
package util
|
||||
|
||||
import (
|
||||
"context"
|
||||
"encoding/json"
|
||||
"fmt"
|
||||
"os"
|
||||
|
||||
"github.com/neo4j/neo4j-go-driver/v5/neo4j"
|
||||
)
|
||||
|
||||
var (
|
||||
Neo4jDriver neo4j.DriverWithContext
|
||||
)
|
||||
|
||||
// 创建 neo4j 服务器的连接
|
||||
func CreateNeo4jDriver(configPath string) (neo4j.DriverWithContext, error) {
|
||||
jsonString, _ := os.ReadFile(configPath)
|
||||
config := make(map[string]string)
|
||||
|
||||
json.Unmarshal(jsonString, &config)
|
||||
// fmt.Printf("url: %s\nname: %s\npassword: %s\n", config["url"], config["name"], config["password"])
|
||||
|
||||
var err error
|
||||
Neo4jDriver, err = neo4j.NewDriverWithContext(
|
||||
config["url"],
|
||||
neo4j.BasicAuth(config["name"], config["password"], ""),
|
||||
)
|
||||
if err != nil {
|
||||
return Neo4jDriver, err
|
||||
}
|
||||
return Neo4jDriver, nil
|
||||
}
|
||||
|
||||
|
||||
// 执行只读的 cypher 查询
|
||||
func ExecuteReadOnlyCypherQuery(
|
||||
cypher string,
|
||||
) ([]map[string]any, error) {
|
||||
session := Neo4jDriver.NewSession(context.TODO(), neo4j.SessionConfig{
|
||||
AccessMode: neo4j.AccessModeRead,
|
||||
})
|
||||
|
||||
defer session.Close(context.TODO())
|
||||
|
||||
result, err := session.Run(context.TODO(), cypher, nil)
|
||||
if err != nil {
|
||||
fmt.Println(err.Error())
|
||||
return nil, err
|
||||
}
|
||||
|
||||
var records []map[string]any
|
||||
for result.Next(context.TODO()) {
|
||||
records = append(records, result.Record().AsMap())
|
||||
}
|
||||
|
||||
return records, nil
|
||||
}
|
||||
```
|
||||
|
||||
main.go 中添加以下代码：
|
||||
|
||||
```go
|
||||
package main
|
||||
|
||||
import (
|
||||
"fmt"
|
||||
"neo4j-go-server/util"
|
||||
)
|
||||
|
||||
var (
|
||||
neo4jPath string = "./neo4j.json"
|
||||
)
|
||||
|
||||
func main() {
|
||||
_, err := util.CreateNeo4jDriver(neo4jPath)
|
||||
if err != nil {
|
||||
fmt.Println(err)
|
||||
return
|
||||
}
|
||||
|
||||
fmt.Println("Neo4j driver created successfully")
|
||||
}
|
||||
```
|
||||
|
||||
运行主程序来验证数据库的连通性：
|
||||
|
||||
```bash
|
||||
go run main.go
|
||||
```
|
||||
|
||||
如果输出了 `Neo4j driver created successfully`，则说明数据库的连通性验证通过。
|
||||
|
||||
|
||||
|
||||
## 3. 实现 mcp 服务器
|
||||
|
||||
go 的 mcp 的 sdk 最为有名的是 mark3labs/mcp-go 了，我们就用这个。
|
||||
|
||||
> mark3labs/mcp-go 的 demo 在 https://github.com/mark3labs/mcp-go，非常简单，此处直接使用即可。
|
||||
|
||||
先安装
|
||||
|
||||
```bash
|
||||
go get github.com/mark3labs/mcp-go
|
||||
```
|
||||
|
||||
然后在 `main.go` 中添加以下代码：
|
||||
|
||||
```go
|
||||
// ... existing code ...
|
||||
|
||||
var (
|
||||
addr string = "localhost:8083"
|
||||
)
|
||||
|
||||
func main() {
|
||||
// ... existing code ...
|
||||
|
||||
s := server.NewMCPServer(
|
||||
"只读 Neo4j 服务器",
|
||||
"0.0.1",
|
||||
server.WithToolCapabilities(true),
|
||||
)
|
||||
|
||||
srv := server.NewSSEServer(s)
|
||||
|
||||
// 定义 executeReadOnlyCypherQuery 这个工具的 schema
|
||||
executeReadOnlyCypherQuery := mcp.NewTool("executeReadOnlyCypherQuery",
|
||||
mcp.WithDescription("执行只读的 Cypher 查询"),
|
||||
mcp.WithString("cypher",
|
||||
mcp.Required(),
|
||||
mcp.Description("Cypher 查询语句，必须是只读的"),
|
||||
),
|
||||
)
|
||||
|
||||
// 将真实函数和申明的 schema 绑定
|
||||
s.AddTool(executeReadOnlyCypherQuery, func(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
|
||||
args, ok := request.Params.Arguments.(map[string]interface{})
|
||||
if !ok {
|
||||
return mcp.NewToolResultText(""), fmt.Errorf("invalid arguments type")
|
||||
}
|
||||
cypher, ok := args["cypher"].(string)
|
||||
if !ok {
|
||||
return mcp.NewToolResultText(""), fmt.Errorf("cypher argument is not a string")
|
||||
}
|
||||
result, err := util.ExecuteReadOnlyCypherQuery(cypher)
|
||||
|
||||
fmt.Println(result)
|
||||
|
||||
if err != nil {
|
||||
return mcp.NewToolResultText(""), err
|
||||
}
|
||||
|
||||
return mcp.NewToolResultText(fmt.Sprintf("%v", result)), nil
|
||||
})
|
||||
|
||||
// 在 http://localhost:8083/sse 开启服务
|
||||
fmt.Printf("Server started at http://%s/sse\n", addr)
|
||||
srv.Start(addr)
|
||||
}
|
||||
```
|
||||
|
||||
go run main.go 运行上面的代码，你就能看到如下信息：
|
||||
|
||||
```
|
||||
Neo4j driver created successfully
|
||||
Server started at http://localhost:8083/sse
|
||||
```
|
||||
|
||||
说明我们的 mcp 服务器在本地的 8083 上启动了。
|
||||
|
||||
|
||||
|
||||
## 4. 通过 openmcp 来进行调试
|
||||
|
||||
### 4.1 添加工作区 sse 调试项目
|
||||
|
||||
接下来，我们来通过 openmcp 进行调试，先点击 vscode 左侧的 openmcp 图标进入控制面板，如果你是下载的 https://github.com/LSTM-Kirigaya/openmcp-tutorial/tree/main/neo4j-go-server 这个项目，那么你能看到【MCP 连接（工作区）】里面已经有一个创建好的调试项目【只读 Neo4j 服务器】了。如果你是完全自己做的这个项目，可以通过下面的按钮添加连接，选择 sse 后填入 http://localhost:8083/sse，oauth 空着不填即可。
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-31a01f1253dfc8c42e23e05b1869a932_1440w.png" style="width: 80%;"/>
|
||||
</div>
|
||||
|
||||
### 4.2 测试工具
|
||||
|
||||
第一次调试 mcp 服务器要做的事情一定是先调通 mcp tool，新建标签页，选择 tool，点击下图的工具，输入 `CALL db.labels() YIELD label RETURN label`，这个语句是用来列出所有节点类型的。如果输出下面的结果，说明当前的链路生效，没有问题。
|
||||
|
||||
<div align=center>
|
||||
<img src="https://pic1.zhimg.com/80/v2-dd59d9c96ecb455e527ab8aa7f963908_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
|
||||
### 4.3 摸清大模型功能边界，用提示词来封装我们的知识
|
||||
|
||||
然后，让我们做点有趣的事情吧！我们接下来要测试一下大模型的能力边界，因为 neo4j 属于特种数据库，通用大模型不一定知道怎么用它。新建标签页，点击「交互测试」，我们先问一个简单的问题：
|
||||
|
||||
```
|
||||
帮我找出最新的 10 条评论
|
||||
```
|
||||
|
||||
结果如下：
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-44fab30650051db4e3b94de34275af3a_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
可以看到，大模型查询的节点类型就是错误的，在我提供的例子中，代表评论的节点是 BlogComment，而不是 Comment。也就是说，大模型并不掌握进行数据库查询的通用方法论。这就是我们目前知道的它的能力边界。我们接下来要一步一步地注入我们的经验和知识，唔姆，通过 system prompt 来完成。
|
||||
|
||||
### 4.4 教大模型找数据库节点
|
||||
|
||||
好好想一下，作为工程师的我们是怎么知道评论的节点是 BlogComment？我们一般是通过罗列当前数据库的所有节点的类型来从命名中猜测的，比如，对于这个数据库，我一般会先输入如下的 cypher 查询：
|
||||
|
||||
```sql
|
||||
CALL db.labels() YIELD label RETURN label
|
||||
```
|
||||
|
||||
它的输出就在 4.2 的图中，如果你的英文不错，也能看出来 BlogComment 大概率是代表博客评论的节点。好了，那么我们将这段方法论注入到 system prompt 中，从而封装我们的这层知识，点击下图的下方的按钮，进入到【系统提示词】:
|
||||
|
||||
<div align=center>
|
||||
<img src="https://pica.zhimg.com/80/v2-e0fdd265e53dd354163358be1f5cc3f6_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
|
||||
新建提示词【neo4j】，输入：
|
||||
|
||||
```
|
||||
你是一个善于进行neo4j查询的智能体，对于用户要求的查询请求，你并不一定知道对应的数据库节点是什么，这个时候，你需要先列出所有的节点类型，然后从中找到你认为最有可能是匹配用户询问的节点。比如用户问你要看符合特定条件的「文章」，你并不知道文章的节点类型是什么，这个时候，你就需要先列出所有的节点。
|
||||
```
|
||||
|
||||
点击保存，然后在【交互测试】中，重复刚才的问题：
|
||||
|
||||
```
|
||||
帮我找出最新的 10 条评论
|
||||
```
|
||||
|
||||
大模型的回答如下：
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-ccf4a5ecb5691620fca659dcd60d2e38_1440w.png" style="width: 80%;"/>
|
||||
</div>
|
||||
|
||||
诶？怎么说，是不是好了很多了？大模型成功找到了 BlogComment 这个节点，然后返回了对应的数据。
|
||||
|
||||
但是其实还是不太对，因为我们要求的说最新的 10 条评论，但是大模型返回的其实是最早的 10 条评论，我们点开大模型的调用细节就能看到，大模型是通过 `ORDER BY comment.createdAt` 来实现的，但是问题是，在我们的数据库中，记录一条评论何时创建的字段并不是 createdAt，而是 createdTime，这意味着大模型并不知道自己不知道节点的字段，从而产生了「幻觉」，瞎输入了一个字段。
|
||||
|
||||
大模型是不会显式说自己不知道的，锦恢研究生关于 OOD 的一项研究可以说明这件事的本质原因：[EDL（Evidential Deep Learning） 原理与代码实现](https://kirigaya.cn/blog/article?seq=154)，如果阁下的好奇心能够配得上您的数学功底，可以一试这篇文章。总之，阁下只需要知道，正因为大模型对自己不知道的东西会产生幻觉，所以才有我们得以注入经验的操作空间。
|
||||
|
||||
### 4.5 教大模型找数据库节点的字段
|
||||
|
||||
通过上面的尝试，我们知道我们距离终点只剩一点了，那就是告诉大模型，我们的数据库中，记录一条评论何时创建的字段并不是 createdAt，而是 createdTime。
|
||||
|
||||
对于识别字段的知识，我们改良一下刚刚的系统提示词下：
|
||||
|
||||
```
|
||||
你是一个善于进行neo4j查询的智能体，对于用户要求的查询请求，你并不一定知道对应的数据库节点是什么，这个时候，你需要先列出所有的节点类型，然后从中找到你认为最有可能是匹配用户询问的节点。比如用户问你要看符合特定条件的「文章」，你并不知道文章的节点类型是什么，这个时候，你就需要先列出所有的节点。
|
||||
|
||||
对于比较具体的查询，你需要先查询单个事例来看一下当前类型有哪些字段。比如用户问你最新的文章，你是不知道文章节点的哪一个字段代表 「创建时间」的，因此，你需要先列出一到两个文章节点，看一下里面有什么字段，然后再创建查询查看最新的10篇文章。
|
||||
```
|
||||
|
||||
结果如下：
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-e7a2faf43249fe108288604a2eb948ad_1440w.png" style="width: 80%;"/>
|
||||
</div>
|
||||
|
||||
|
||||
是不是很完美？
|
||||
|
||||
通过使用 openmcp 调试，我们可以通过 system prompt + mcp server 来唯一确定一个 agent 的表现行为。
|
||||
|
||||
|
||||
|
||||
## 5. 扩充 mcp 服务器的原子技能
|
||||
|
||||
在上面的例子中，虽然我们通过 system prompt 注入了我们的经验和知识，但是其实你会发现这些我们注入的行为，比如「查询所有节点类型」和「获取一个节点的所有字段」，是不是流程很固定？但是 system prompt 是通过自然语言编写的，它具有语言特有的模糊性，我们无法保证它一定是可以拓展的。那么除了 system prompt，还有什么方法可以注入我们的经验与知识呢？有的，兄弟，有的。
|
||||
|
||||
在这种流程固定，而且这个操作也非常地容易让「稍微有点经验的人」也能想到的情况下，除了使用 system prompt 外，我们还有一个方法可以做到更加标准化地注入知识，也就是把上面的这些个流程写成额外的 mcp tool。这个方法被我称为「原子化扩充」(Atomization Supplement)。
|
||||
|
||||
所谓原子化扩充，也就是增加额外的 mcp tool，这些 tool 在功能层面是「原子化」的。
|
||||
|
||||
> 满足如下条件之一的 tool，被称为 原子 tool (Atomic Tool)：
|
||||
> tool 无法由更加细粒度的功能通过有限组合得到
|
||||
> 组成得到 tool 的更加细粒度的功能，大模型并不会完全使用，或者使用不可靠 (比如汇编语言，比如 DOM 查询)
|
||||
|
||||
扩充额外的原子 tool，能够让大模型知道 “啊！我还有别的手段可以耍！” ，那么只要 description 比较恰当，大模型就能够使用它们来获得额外的信息，而不是产生「幻觉」让任务失败。
|
||||
|
||||
对于上面的一整套流程，我们目前知道了如下两个技能大模型是会产生「幻觉」的：
|
||||
|
||||
1. 获取一个节点类别的标签（询问评论，大模型没说自己不知道什么是评论标签，而是直接使用了 Comment，但是实际的评论标签是 BlogComment）
|
||||
2. 获取一个节点类别的字段（询问最新评论，大模型选择通过 createAt 排序，但是记录 BlogComment 创建时间的字段是 createTime）
|
||||
|
||||
在之前，我们通过了 system prompt 来完成了信息的注入，现在，丢弃你的 system prompt 吧！我们来玩点更加有趣的游戏。在刚刚的 util.go 中，我们针对上面的两个幻觉，实现两个额外的函数 (经过测试，cursor或者trae能完美生成下面的代码，可以不用自己写)：
|
||||
|
||||
```go
|
||||
// 获取所有的节点类型
|
||||
func GetAllNodeTypes() ([]string, error) {
|
||||
cypher := "MATCH (n) RETURN DISTINCT labels(n) AS labels"
|
||||
result, err := ExecuteReadOnlyCypherQuery(cypher)
|
||||
if err!= nil {
|
||||
return nil, err
|
||||
}
|
||||
var nodeTypes []string
|
||||
for _, record := range result {
|
||||
labels := record["labels"].([]any)
|
||||
for _, label := range labels {
|
||||
nodeTypes = append(nodeTypes, label.(string))
|
||||
}
|
||||
}
|
||||
return nodeTypes, nil
|
||||
}
|
||||
|
||||
// 获取一个节点的字段示范
|
||||
func GetNodeFields(nodeType string) ([]string, error) {
|
||||
cypher := fmt.Sprintf("MATCH (n:%s) RETURN keys(n) AS keys LIMIT 1", nodeType)
|
||||
result, err := ExecuteReadOnlyCypherQuery(cypher)
|
||||
if err!= nil {
|
||||
return nil, err
|
||||
}
|
||||
var fields []string
|
||||
for _, record := range result {
|
||||
keys := record["keys"].([]any)
|
||||
for _, key := range keys {
|
||||
fields = append(fields, key.(string))
|
||||
}
|
||||
}
|
||||
return fields, nil
|
||||
}
|
||||
```
|
||||
|
||||
在 main.go 中完成它们的 schema 的申明和 tool 的注册：
|
||||
|
||||
```go
|
||||
// ... existing code ...
|
||||
|
||||
getAllNodeTypes := mcp.NewTool("getAllNodeTypes",
|
||||
mcp.WithDescription("获取所有的节点类型"),
|
||||
)
|
||||
|
||||
getNodeField := mcp.NewTool("getNodeField",
|
||||
mcp.WithDescription("获取节点的字段"),
|
||||
mcp.WithString("nodeLabel",
|
||||
mcp.Required(),
|
||||
mcp.Description("节点的标签"),
|
||||
),
|
||||
)
|
||||
|
||||
// 注册对应的工具到 schema 上
|
||||
s.AddTool(getAllNodeTypes, func(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
|
||||
result, err := util.GetAllNodeTypes()
|
||||
|
||||
fmt.Println(result)
|
||||
|
||||
if err != nil {
|
||||
return mcp.NewToolResultText(""), err
|
||||
}
|
||||
|
||||
return mcp.NewToolResultText(fmt.Sprintf("%v", result)), nil
|
||||
})
|
||||
|
||||
s.AddTool(getNodeField, func(ctx context.Context, request mcp.CallToolRequest) (*mcp.CallToolResult, error) {
|
||||
args, ok := request.Params.Arguments.(map[string]interface{})
|
||||
if !ok {
|
||||
return mcp.NewToolResultText(""), fmt.Errorf("invalid arguments type")
|
||||
}
|
||||
nodeLabel, ok := args["nodeLabel"].(string)
|
||||
if !ok {
|
||||
return mcp.NewToolResultText(""), fmt.Errorf("nodeLabel argument is not a string")
|
||||
}
|
||||
result, err := util.GetNodeFields(nodeLabel)
|
||||
|
||||
fmt.Println(result)
|
||||
|
||||
if err!= nil {
|
||||
return mcp.NewToolResultText(""), err
|
||||
}
|
||||
|
||||
return mcp.NewToolResultText(fmt.Sprintf("%v", result)), nil
|
||||
})
|
||||
|
||||
// ... existing code ...
|
||||
```
|
||||
|
||||
重新运行 sse 服务器，然后直接询问大模型，此时，我们取消使用 system prompt（创建一个空的，或者直接把当前的 prompt 删除），询问结果如下：
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-1e88f7d8e04b949040a02673c13d6462_1440w.png" style="width: 80%;"/>
|
||||
</div>
|
||||
|
||||
|
||||
可以看到，在没有 system prompt 的情况下，大模型成功执行了这个过程，非常完美。
|
||||
|
||||
## 总结
|
||||
|
||||
这期教程，带大家使用 go 走完了 mcp sse 的连接方式，并且做出了一个「只读 neo4j 数据库」的 mcp，通过这个 mcp，我们可以非常方便地用自然语言查询数据库的结果，而不需要手动输入 cypher。
|
||||
|
||||
对于部分情况下，大模型因为「幻觉」问题而导致的任务失败，我们通过一步步有逻辑可遵循的方法论，完成了 system prompt 的调优和知识的封装。最终，通过范式化的原子化扩充的方式，将这些知识包装成了更加完善的 mcp 服务器。这样，任何人都可以直接使用你的 mcp 服务器来完成 neo4j 数据库的自然语言查询了。
|
||||
|
||||
最后，觉得 openmcp 好用的米娜桑，别忘了给我们的项目点个 star：https://github.com/LSTM-Kirigaya/openmcp-client
|
||||
|
||||
想要和我进一步交流 OpenMCP 的朋友，可以进入我们的交流群（github 项目里面有）
|
||||
0
en/plugin-tutorial/examples/java-es-http.md
Normal file
0
en/plugin-tutorial/examples/java-es-http.md
Normal file
28
en/plugin-tutorial/examples/mcp-examples.md
Normal file
28
en/plugin-tutorial/examples/mcp-examples.md
Normal file
@ -0,0 +1,28 @@
|
||||
---
|
||||
next:
|
||||
text: python 实现天气信息 mcp 服务器 (STDIO)
|
||||
link: '/plugin-tutorial/examples/python-simple-stdio'
|
||||
---
|
||||
|
||||
# MCP 服务器开发案例
|
||||
|
||||
## Python
|
||||
- [python 实现天气信息 mcp 服务器 (STDIO)](./python-simple-stdio)
|
||||
- [python 实现进行通用表单填充 的 mcp (STDIO)](./python-form-stdio)
|
||||
- [python 实现基于 blender 的 mcp (STDIO)](./python-blender-stdio)
|
||||
- [python 实现 cadence EDA 的 mcp (STDIO)](./python-cadence-stdio)
|
||||
- 基于 ffmpeg mcp 实现通过对话的视频剪辑
|
||||
- 基于 rag mcp 实现知识库的注入
|
||||
- 实现 Stable Diffusion 的 MCP 服务器
|
||||
|
||||
## Nodejs
|
||||
- [typescript 实现基于 crawl4ai 的超级网页爬虫 mcp (STDIO)](./typescript-crawl4ai-stdio)
|
||||
|
||||
## Go
|
||||
- [go 实现 neo4j 的只读 mcp 服务器 (SSE)](./go-neo4j-sse)
|
||||
|
||||
## Java
|
||||
- [java 实现文档数据库的只读 mcp (HTTP)](./java-es-http)
|
||||
|
||||
## 认证
|
||||
- [SSE 方式的 OAuth2 认证 mcp 服务器示例](./sse-oauth2)
|
||||
436
en/plugin-tutorial/examples/python-blender-stdio.md
Normal file
436
en/plugin-tutorial/examples/python-blender-stdio.md
Normal file
@ -0,0 +1,436 @@
|
||||
# python 实现天气信息 mcp 服务器
|
||||
|
||||
## hook
|
||||
|
||||
等等，开始前，先让我们看一个小例子，假设我下周要去明日方舟锈影新生的漫展，所以我想要知道周六杭州的天气，于是我问大模型周六的天气，结果大模型给了我如下的回复：
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-4c623ac6897e12093535b0d9ed9cf242_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
这可不行，相信朋友们也经常遇到过这样的情况，大模型总是会“授人以渔”，但是有的时候，我们往往就是想要直接知道最终结果，特别是一些无聊的生活琐事。
|
||||
|
||||
其实实现天气预报的程序也很多啦，那么有什么方法可以把写好的天气预报的程序接入大模型，让大模型告诉我们真实的天气情况，从而选择明天漫展的穿搭选择呢？
|
||||
|
||||
如果直接写函数用 function calling 显得有点麻烦，这里面涉及到很多麻烦的技术细节需要我们商榷，比如大模型提供商的API调用呀，任务循环的搭建呀，文本渲染等等，从而浪费我们宝贵的时间。而 MCP 给了我们救赎之道，今天这期教程，就教大家写一个简单的 MCP 服务器，可以让大模型拥有得知天气预报的能力。
|
||||
|
||||
|
||||
|
||||
## 前言
|
||||
|
||||
👉 [上篇导航](https://zhuanlan.zhihu.com/p/32593727614)
|
||||
|
||||
在上篇，我们简单讲解了 MCP 的基础，在这一篇，我们将正式开始着手开发我们自己的 MCP 服务器，从而将现成的应用，服务，硬件等等接入大模型。从而走完大模型到赋能终端应用的最后一公里。
|
||||
|
||||
工欲善其事，必先利其器。为了更加优雅快乐地开发 MCP 服务器，我们需要一个比较好的测试工具，允许我们在开发的过程看到程序的变化，并且可以直接接入大模型验证工具的有效性。
|
||||
|
||||
于是，我在前不久开源了一款一体化的 MCP 测试开发工具 —— OpenMCP，[全网第一个 MCP 服务器一体化开发测试软件 OpenMCP 发布！](https://zhuanlan.zhihu.com/p/1894785817186121106)
|
||||
|
||||
> OpenMCP QQ 群 782833642
|
||||
|
||||
OpenMCP 开源链接：https://github.com/LSTM-Kirigaya/openmcp-client
|
||||
|
||||
求个 star :D
|
||||
|
||||
### 第一个 MCP 项目
|
||||
|
||||
事已至此，先 coding 吧 :D
|
||||
|
||||
在打开 vscode 或者 trae 之前，先安装基本的 uv 工具，uv 是一款社区流行的版本管理工具，你只需要把它理解为性能更好的 conda 就行了。
|
||||
|
||||
我们先安装 uv，如果您正在使用 anaconda，一定要切换到 base 环境，再安装：
|
||||
|
||||
```bash
|
||||
pip install uv
|
||||
```
|
||||
|
||||
安装完成后，运行 uv
|
||||
|
||||
```bash
|
||||
uv
|
||||
```
|
||||
|
||||
没有报错就说明成功。uv 只会将不可以复用的依赖安装在本地，所以使用 anaconda 的朋友不用担心，uv 安装的依赖库会污染你的 base，我们接下来使用 uv 来创建一个基础的 python 项目
|
||||
|
||||
```bash
|
||||
mkdir simple-mcp && cd simple-mcp
|
||||
uv init
|
||||
uv add mcp "mcp[cli]"
|
||||
```
|
||||
|
||||
然后我们打开 vscode 或者 trae，在插件商城找到并下载 OpenMCP 插件
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-525c4576398078547fdd6eeef26532aa_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
先制作一个 MCP 的最小程序：
|
||||
|
||||
文件名：simple_mcp.py
|
||||
|
||||
```python
|
||||
from mcp.server.fastmcp import FastMCP
|
||||
|
||||
mcp = FastMCP('锦恢的 MCP Server', version="11.45.14")
|
||||
|
||||
@mcp.tool(
|
||||
name='add',
|
||||
description='对两个数字进行实数域的加法'
|
||||
)
|
||||
def add(a: int, b: int) -> int:
|
||||
return a + b
|
||||
|
||||
@mcp.resource(
|
||||
uri="greeting://{name}",
|
||||
name='greeting',
|
||||
description='用于演示的一个资源协议'
|
||||
)
|
||||
def get_greeting(name: str) -> str:
|
||||
# 访问处理 greeting://{name} 资源访问协议，然后返回
|
||||
# 此处方便起见，直接返回一个 Hello，balabala 了
|
||||
return f"Hello, {name}!"
|
||||
|
||||
@mcp.prompt(
|
||||
name='translate',
|
||||
description='进行翻译的prompt'
|
||||
)
|
||||
def translate(message: str) -> str:
|
||||
return f'请将下面的话语翻译成中文：\n\n{message}'
|
||||
|
||||
@mcp.tool(
|
||||
name='weather',
|
||||
description='获取指定城市的天气信息'
|
||||
)
|
||||
def get_weather(city: str) -> str:
|
||||
"""模拟天气查询协议，返回格式化字符串"""
|
||||
return f"Weather in {city}: Sunny, 25°C"
|
||||
|
||||
@mcp.resource(
|
||||
uri="user://{user_id}",
|
||||
name='user_profile',
|
||||
description='获取用户基本信息'
|
||||
)
|
||||
def get_user_profile(user_id: str) -> dict:
|
||||
"""模拟用户协议，返回字典数据"""
|
||||
return {
|
||||
"id": user_id,
|
||||
"name": "张三",
|
||||
"role": "developer"
|
||||
}
|
||||
|
||||
@mcp.resource(
|
||||
uri="book://{isbn}",
|
||||
name='book_info',
|
||||
description='通过ISBN查询书籍信息'
|
||||
)
|
||||
def get_book_info(isbn: str) -> dict:
|
||||
"""模拟书籍协议，返回结构化数据"""
|
||||
return {
|
||||
"isbn": isbn,
|
||||
"title": "Python编程：从入门到实践",
|
||||
"author": "Eric Matthes"
|
||||
}
|
||||
|
||||
@mcp.prompt(
|
||||
name='summarize',
|
||||
description='生成文本摘要的提示词模板'
|
||||
)
|
||||
def summarize(text: str) -> str:
|
||||
"""返回摘要生成提示词"""
|
||||
return f"请用一句话总结以下内容：\n\n{text}"
|
||||
```
|
||||
|
||||
我们试着运行它：
|
||||
|
||||
|
||||
```bash
|
||||
uv run mcp run simple_mcp.py
|
||||
```
|
||||
|
||||
如果没有报错，但是卡住了，那么说明我们的依赖安装没有问题，按下 ctrl c 或者 ctrl z 退出即可。
|
||||
|
||||
在阁下看起来，这些函数都简单到毫无意义，但是请相信我，我们总需要一些简单的例子来通往最终的系统。
|
||||
|
||||
### Link, Start!
|
||||
|
||||
如果你下载了 OpenMCP 插件，那么此时你就能在打开的 python 编辑器的右上角看到 OpenMCP 的紫色图标，点击它就能启动 OpenMCP，调试当前的 MCP 了。
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-f67e000371095a755d2f0d613706d61c_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
默认是以 STDIO 的方式启动，默认运行如下的命令：
|
||||
|
||||
```bash
|
||||
uv run mcp run <当前打开的 python 文件的相对路径>
|
||||
```
|
||||
|
||||
所以你需要保证已经安装了 mcp 脚手架，也就是 `uv add mcp "mcp[cli]"`。
|
||||
|
||||
打开后第一件事就是先看左下角连接状态，确保是绿色的，代表当前 OpenMCP 和你的 MCP 服务器已经握手成功。
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-c4ebbbfe98d51e8b6e7de6c6d1bceb2e_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
如果连接成功，此时连接上方还会显示你当前的 MCP 服务器的名字，光标移动上去还能看到版本号。这些信息由我们如下的代码定义：
|
||||
|
||||
```python
|
||||
mcp = FastMCP('锦恢的 MCP Server', version="11.45.14")
|
||||
```
|
||||
|
||||
这在我们进行版本管理的时候会非常有用。请善用这套系统。
|
||||
|
||||
|
||||
如果连接失败，可以点击左侧工具栏的第二个按钮，进入连接控制台，查看错误信息，或是手动调整连接命令：
|
||||
|
||||
<div align=center>
|
||||
<img src="https://pic1.zhimg.com/80/v2-684190b98dbbb9a7bf0e8c8048bd1277_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
### 初识 OpenMCP
|
||||
|
||||
接下来，我来简单介绍一下 OpenMCP 的基本功能模块，如果一开始，你的屏幕里什么也没有，先点击上面的加号创建一个新的标签页，此处页面中会出现下图屏幕中的四个按钮
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-3a4e8aa1ddaac632601532bb757a15ad_1440w.png?source=d16d100b" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
放大一点
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-ecc0705ed534e2cf0bc748ecd95f5f22_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
前三个，资源、提词和工具，分别用于调试 MCP 中的三个对应项目，也就是 Resources，Prompts 和 Tools，这三个部分的使用，基本和 MCP 官方的 Inspector 工具是一样的，那是自然，我就照着这几个抄的，诶嘿。
|
||||
|
||||
<div align=center>
|
||||
<img src="https://pica.zhimg.com/80/v2-d767e782f667161442ea183f55ca49b1_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
然后第四个按钮「交互测试」，它是一个我开发的 MCP 客户端，其实就是一个对话窗口，你可以无缝衔接地直接在大模型中测试你当前的 MCP 服务器的功能函数。
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-b59ee2d290e096343fb4659baf34cf57_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
|
||||
目前我暂时只支持 tools 的支持，因为 prompts 和 resources 的我还没有想好，（resource 感觉就是可以当成一个 tool），欢迎大家进群和我一起讨论：QQ群 782833642
|
||||
|
||||
|
||||
|
||||
## 开始调试天气函数
|
||||
|
||||
### 工具调试
|
||||
|
||||
还记得我们一开始给的 mcp 的例子吗？我们可以通过 OpenMCP 来快速调试这里面写的函数，比如我们本期的目标，写一个天气预报的 MCP，那么假设我们已经写好了一个天气预报的函数了，我们把它封装成一个 tool：
|
||||
|
||||
```python
|
||||
@mcp.tool(
|
||||
name='weather',
|
||||
description='获取指定城市的天气信息'
|
||||
)
|
||||
def get_weather(city: str) -> str:
|
||||
"""模拟天气查询协议，返回格式化字符串"""
|
||||
return f"Weather in {city}: Sunny, 25°C"
|
||||
```
|
||||
|
||||
当然，它现在是没有意义的，因为就算把黑龙江的城市ID输入，它也返回 25 度，但是这些都不重要，我想要带阁下先走完整套流程。建立自上而下的感性认知比死抠细节更加容易让用户学懂。
|
||||
|
||||
那么我们现在需要调试这个函数，打开 OpenMCP，新建一个「工具」调试项目
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-1c67ab54d67023e408413484768377cf_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
然后此时，你在左侧的列表可以看到 weather 这个工具，选择它，然后在右侧的输入框中随便输入一些东西，按下回车（或者点击「运行」），你能看到如下的响应：
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-d32a9c0d9fcab497dc03152a72c4c62b_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
看到我们函数 return 的字符串传过来了，说明没问题，链路通了。
|
||||
|
||||
### 交互测试
|
||||
|
||||
诶？我知道你编程很厉害，但是，在噼里啪啦快速写完天气预报爬虫前，我们现在看看我们要如何把已经写好的工具注入大模型对话中。为了使用大模型，我们需要先选择大模型和对应的 API，点击左侧工具栏的第三个按钮，进入 API 模块，选择你想要使用的大模型运营商、模型，填写 API token，然后点击下面的「保存」
|
||||
|
||||
<div align=center>
|
||||
<img src="https://pic1.zhimg.com/80/v2-367780b204d2aa50354585272b71af20_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
再新建一个标签页，选择「交互测试」，此时，我们就可以直接和大模型对话了，我们先看看没有任何工具注入的大模型会如何回应天气预报的问题，点击最下侧工具栏从左往右第三个按钮，进入工具选择界面，选择「禁用所有工具」
|
||||
|
||||
<div align=center>
|
||||
<img src="https://pic1.zhimg.com/80/v2-977a53ea14eae5e1a646fc73d379a422_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
点击「关闭」后，我们问大模型一个问题：
|
||||
|
||||
```
|
||||
请问杭州的温度是多少？
|
||||
```
|
||||
|
||||
<div align=center>
|
||||
<img src="https://pic1.zhimg.com/80/v2-d3aa56602f574a6968295f9a5c93438f_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
可以看到，大模型给出了和文章开头一样的回答。非常敷衍，因为它确实无法知道。
|
||||
|
||||
此处，我们再单独打开「weather」工具：
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-2ed66eaff604d11d52f60201fca215d4_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
问出相同的问题：
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-e934d386e20b1de43fb5e0dd426de86e_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
可以看到，大模型给出了回答是 25 度，还有一些额外的推导信息。
|
||||
|
||||
我们不妨关注一些细节，首先，大模型并不会直接回答问题，而是会先去调用 weather 这个工具，调用参数为：
|
||||
|
||||
```json
|
||||
{
|
||||
"city": "杭州"
|
||||
}
|
||||
```
|
||||
|
||||
然后，我们的 MCP 服务器给出了响应：
|
||||
|
||||
```
|
||||
Weather in 杭州: Sunny, 25°C
|
||||
```
|
||||
|
||||
从而，最终大模型才根据这些信息给出了最终的回答。也就是，这个过程我们实际调用了两次大模型的服务。而且可以看到两次调用的输入 token 数量都非常大，这是因为 OpenMCP 会将函数调用以 JSON Schema 的形式注入到请求参数中，weather 这个工具的 JSON Schema 如下图的右侧的 json 所示：
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-2ed66eaff604d11d52f60201fca215d4_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
然后支持 openai 协议的大模型厂商都会针对这样的信息进行 function calling，所以使用了工具的大模型请求的输入 token 数量都会比较大。但是不需要担心，大部分厂商都实现了 KV Cache，对相同前缀的输入存在缓存，缓存命中部分的费用开销是显著低于普通的 输入输出 token 价格的。OpenMCP 在每个回答的下面都表明了当次请求的 输入 token，输出 token，总 token 和 缓存命中率。
|
||||
|
||||
其中
|
||||
|
||||
- 「总 token」 = 「输入 token」 + 「输出 token」
|
||||
|
||||
- 「缓存命中率」 = 「缓存命令的 token」 / 「输入 token」
|
||||
|
||||
> 没错，缓存命中率 是对于输入 token 的概念，输出 token 是没有 缓存命中率这个说法的。
|
||||
|
||||
在后续的开发中，你可以根据这些信息来针对性地对你的服务或者 prompt 进行调优。
|
||||
|
||||
### 完成一个真正的天气预报吧！
|
||||
|
||||
当然，这些代码也非常简单，直接让大模型生成就行了（其实大模型是无法生成免 API 的 python 获取天气的代码的，我是直接让大模型把我个人网站上天气预报的 go 函数翻译了一下）
|
||||
|
||||
我直接把函数贴上来了：
|
||||
|
||||
```python
|
||||
import requests
|
||||
import json
|
||||
from typing import NamedTuple, Optional
|
||||
|
||||
class CityWeather(NamedTuple):
|
||||
city_name_en: str
|
||||
city_name_cn: str
|
||||
city_code: str
|
||||
temp: str
|
||||
wd: str
|
||||
ws: str
|
||||
sd: str
|
||||
aqi: str
|
||||
weather: str
|
||||
|
||||
def get_city_weather_by_city_name(city_code: str) -> Optional[CityWeather]:
|
||||
"""根据城市名获取天气信息"""
|
||||
|
||||
if not city_code:
|
||||
print(f"找不到{city_code}对应的城市")
|
||||
return None
|
||||
|
||||
try:
|
||||
# 构造请求URL
|
||||
url = f"http://d1.weather.com.cn/sk_2d/{city_code}.html"
|
||||
|
||||
# 设置请求头
|
||||
headers = {
|
||||
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36 Edg/115.0.0.0",
|
||||
"Host": "d1.weather.com.cn",
|
||||
"Referer": "http://www.weather.com.cn/"
|
||||
}
|
||||
|
||||
# 发送HTTP请求
|
||||
response = requests.get(url, headers=headers)
|
||||
response.raise_for_status()
|
||||
|
||||
# 解析JSON数据
|
||||
# 解析JSON数据前先处理编码问题
|
||||
content = response.text.encode('latin1').decode('unicode_escape')
|
||||
json_start = content.find("{")
|
||||
json_str = content[json_start:]
|
||||
|
||||
weather_data = json.loads(json_str)
|
||||
|
||||
# 构造返回对象
|
||||
return CityWeather(
|
||||
city_name_en=weather_data.get("nameen", ""),
|
||||
city_name_cn=weather_data.get("cityname", "").encode('latin1').decode('utf-8'),
|
||||
city_code=weather_data.get("city", ""),
|
||||
temp=weather_data.get("temp", ""),
|
||||
wd=weather_data.get("wd", "").encode('latin1').decode('utf-8'),
|
||||
ws=weather_data.get("ws", "").encode('latin1').decode('utf-8'),
|
||||
sd=weather_data.get("sd", ""),
|
||||
aqi=weather_data.get("aqi", ""),
|
||||
weather=weather_data.get("weather", "").encode('latin1').decode('utf-8')
|
||||
)
|
||||
|
||||
except Exception as e:
|
||||
print(f"获取天气信息失败: {str(e)}")
|
||||
return None
|
||||
|
||||
from mcp.server.fastmcp import FastMCP
|
||||
|
||||
mcp = FastMCP('weather', version="0.0.1")
|
||||
|
||||
@mcp.tool(
|
||||
name='get_weather_by_city_code',
|
||||
description='根据城市天气预报的城市编码 (int)，获取指定城市的天气信息'
|
||||
)
|
||||
def get_weather_by_code(city_code: int) -> str:
|
||||
"""模拟天气查询协议，返回格式化字符串"""
|
||||
city_weather = get_city_weather_by_city_name(city_code)
|
||||
return str(city_weather)
|
||||
```
|
||||
|
||||
|
||||
这里有几个点一定要注意：
|
||||
|
||||
1. 如果你的输入参数是数字，就算是城市编码这种比较长的数字，请一定定义成 int，因为 mcp 底层的是要走 JSON 正反序列化的，而 "114514" 这样的字符串会被 JSON 反序列化成 114514，而不是 "114514" 这个字符串。你实在要用 str 来表示一个很长的数字，那么就在前面加一个前缀，比如 "code-114514"，避免被反序列化成数字，从而触发 mcp 内部的 type check error
|
||||
2. tool 的 name 请按照 python 的变量命名要求进行命名，否则部分大模型厂商会给你报错。
|
||||
|
||||
好，我们先测试一下：
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-d2dbe925010b676482ee57258c14fca7_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
可以看到，我们的天气查询工具已经可以正常工作了。
|
||||
|
||||
那么接下来，我们就可以把这个工具注入到大模型中了。点击 「交互测试」，只激活当前这个工具，然后询问大模型：
|
||||
```
|
||||
请问杭州的天气是多少？
|
||||
```
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-e581c6461190b358adda50ce83633520_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
完美！
|
||||
|
||||
如此，我们便完成了一个天气查询工具的开发。并且轻松地注入到了我们的大模型中。在实际提供商业级部署方案的时候，虽然 mcp 目前的 stdio 冷启动速度足够快，但是考虑到拓展性等多方面因素，SSE 还是我们首选的连接方案，关于 SSE 的使用，我们下期再聊。
|
||||
|
||||
OpenMCP 开源链接：https://github.com/LSTM-Kirigaya/openmcp-client
|
||||
0
en/plugin-tutorial/examples/python-cadence-stdio.md
Normal file
0
en/plugin-tutorial/examples/python-cadence-stdio.md
Normal file
0
en/plugin-tutorial/examples/python-form-stdio.md
Normal file
0
en/plugin-tutorial/examples/python-form-stdio.md
Normal file
438
en/plugin-tutorial/examples/python-simple-stdio.md
Normal file
438
en/plugin-tutorial/examples/python-simple-stdio.md
Normal file
@ -0,0 +1,438 @@
|
||||
# python 实现天气信息 mcp 服务器
|
||||
|
||||
[本期教程视频](https://www.bilibili.com/video/BV1zYGozgEHc)
|
||||
|
||||
## hook
|
||||
|
||||
等等，开始前，先让我们看一个小例子，假设我下周要去明日方舟锈影新生的漫展，所以我想要知道周六杭州的天气，于是我问大模型周六的天气，结果大模型给了我如下的回复：
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-4c623ac6897e12093535b0d9ed9cf242_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
这可不行，相信朋友们也经常遇到过这样的情况，大模型总是会“授人以渔”，但是有的时候，我们往往就是想要直接知道最终结果，特别是一些无聊的生活琐事。
|
||||
|
||||
其实实现天气预报的程序也很多啦，那么有什么方法可以把写好的天气预报的程序接入大模型，让大模型告诉我们真实的天气情况，从而选择明天漫展的穿搭选择呢？
|
||||
|
||||
如果直接写函数用 function calling 显得有点麻烦，这里面涉及到很多麻烦的技术细节需要我们商榷，比如大模型提供商的API调用呀，任务循环的搭建呀，文本渲染等等，从而浪费我们宝贵的时间。而 MCP 给了我们救赎之道，今天这期教程，就教大家写一个简单的 MCP 服务器，可以让大模型拥有得知天气预报的能力。
|
||||
|
||||
|
||||
|
||||
## 前言
|
||||
|
||||
👉 [上篇导航](https://zhuanlan.zhihu.com/p/32593727614)
|
||||
|
||||
在上篇，我们简单讲解了 MCP 的基础，在这一篇，我们将正式开始着手开发我们自己的 MCP 服务器，从而将现成的应用，服务，硬件等等接入大模型。从而走完大模型到赋能终端应用的最后一公里。
|
||||
|
||||
工欲善其事，必先利其器。为了更加优雅快乐地开发 MCP 服务器，我们需要一个比较好的测试工具，允许我们在开发的过程看到程序的变化，并且可以直接接入大模型验证工具的有效性。
|
||||
|
||||
于是，我在前不久开源了一款一体化的 MCP 测试开发工具 —— OpenMCP，[全网第一个 MCP 服务器一体化开发测试软件 OpenMCP 发布！](https://zhuanlan.zhihu.com/p/1894785817186121106)
|
||||
|
||||
> OpenMCP QQ 群 782833642
|
||||
|
||||
OpenMCP 开源链接：https://github.com/LSTM-Kirigaya/openmcp-client
|
||||
|
||||
求个 star :D
|
||||
|
||||
### 第一个 MCP 项目
|
||||
|
||||
事已至此，先 coding 吧 :D
|
||||
|
||||
在打开 vscode 或者 trae 之前，先安装基本的 uv 工具，uv 是一款社区流行的版本管理工具，你只需要把它理解为性能更好的 conda 就行了。
|
||||
|
||||
我们先安装 uv，如果您正在使用 anaconda，一定要切换到 base 环境，再安装：
|
||||
|
||||
```bash
|
||||
pip install uv
|
||||
```
|
||||
|
||||
安装完成后，运行 uv
|
||||
|
||||
```bash
|
||||
uv
|
||||
```
|
||||
|
||||
没有报错就说明成功。uv 只会将不可以复用的依赖安装在本地，所以使用 anaconda 的朋友不用担心，uv 安装的依赖库会污染你的 base，我们接下来使用 uv 来创建一个基础的 python 项目
|
||||
|
||||
```bash
|
||||
mkdir simple-mcp && cd simple-mcp
|
||||
uv init
|
||||
uv add mcp "mcp[cli]"
|
||||
```
|
||||
|
||||
然后我们打开 vscode 或者 trae，在插件商城找到并下载 OpenMCP 插件
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-525c4576398078547fdd6eeef26532aa_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
先制作一个 MCP 的最小程序：
|
||||
|
||||
文件名：simple_mcp.py
|
||||
|
||||
```python
|
||||
from mcp.server.fastmcp import FastMCP
|
||||
|
||||
mcp = FastMCP('锦恢的 MCP Server', version="11.45.14")
|
||||
|
||||
@mcp.tool(
|
||||
name='add',
|
||||
description='对两个数字进行实数域的加法'
|
||||
)
|
||||
def add(a: int, b: int) -> int:
|
||||
return a + b
|
||||
|
||||
@mcp.resource(
|
||||
uri="greeting://{name}",
|
||||
name='greeting',
|
||||
description='用于演示的一个资源协议'
|
||||
)
|
||||
def get_greeting(name: str) -> str:
|
||||
# 访问处理 greeting://{name} 资源访问协议，然后返回
|
||||
# 此处方便起见，直接返回一个 Hello，balabala 了
|
||||
return f"Hello, {name}!"
|
||||
|
||||
@mcp.prompt(
|
||||
name='translate',
|
||||
description='进行翻译的prompt'
|
||||
)
|
||||
def translate(message: str) -> str:
|
||||
return f'请将下面的话语翻译成中文：\n\n{message}'
|
||||
|
||||
@mcp.tool(
|
||||
name='weather',
|
||||
description='获取指定城市的天气信息'
|
||||
)
|
||||
def get_weather(city: str) -> str:
|
||||
"""模拟天气查询协议，返回格式化字符串"""
|
||||
return f"Weather in {city}: Sunny, 25°C"
|
||||
|
||||
@mcp.resource(
|
||||
uri="user://{user_id}",
|
||||
name='user_profile',
|
||||
description='获取用户基本信息'
|
||||
)
|
||||
def get_user_profile(user_id: str) -> dict:
|
||||
"""模拟用户协议，返回字典数据"""
|
||||
return {
|
||||
"id": user_id,
|
||||
"name": "张三",
|
||||
"role": "developer"
|
||||
}
|
||||
|
||||
@mcp.resource(
|
||||
uri="book://{isbn}",
|
||||
name='book_info',
|
||||
description='通过ISBN查询书籍信息'
|
||||
)
|
||||
def get_book_info(isbn: str) -> dict:
|
||||
"""模拟书籍协议，返回结构化数据"""
|
||||
return {
|
||||
"isbn": isbn,
|
||||
"title": "Python编程：从入门到实践",
|
||||
"author": "Eric Matthes"
|
||||
}
|
||||
|
||||
@mcp.prompt(
|
||||
name='summarize',
|
||||
description='生成文本摘要的提示词模板'
|
||||
)
|
||||
def summarize(text: str) -> str:
|
||||
"""返回摘要生成提示词"""
|
||||
return f"请用一句话总结以下内容：\n\n{text}"
|
||||
```
|
||||
|
||||
我们试着运行它：
|
||||
|
||||
|
||||
```bash
|
||||
uv run mcp run simple_mcp.py
|
||||
```
|
||||
|
||||
如果没有报错，但是卡住了，那么说明我们的依赖安装没有问题，按下 ctrl c 或者 ctrl z 退出即可。
|
||||
|
||||
在阁下看起来，这些函数都简单到毫无意义，但是请相信我，我们总需要一些简单的例子来通往最终的系统。
|
||||
|
||||
### Link, Start!
|
||||
|
||||
如果你下载了 OpenMCP 插件，那么此时你就能在打开的 python 编辑器的右上角看到 OpenMCP 的紫色图标，点击它就能启动 OpenMCP，调试当前的 MCP 了。
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-f67e000371095a755d2f0d613706d61c_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
默认是以 STDIO 的方式启动，默认运行如下的命令：
|
||||
|
||||
```bash
|
||||
uv run mcp run <当前打开的 python 文件的相对路径>
|
||||
```
|
||||
|
||||
所以你需要保证已经安装了 mcp 脚手架，也就是 `uv add mcp "mcp[cli]"`。
|
||||
|
||||
打开后第一件事就是先看左下角连接状态，确保是绿色的，代表当前 OpenMCP 和你的 MCP 服务器已经握手成功。
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-c4ebbbfe98d51e8b6e7de6c6d1bceb2e_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
如果连接成功，此时连接上方还会显示你当前的 MCP 服务器的名字，光标移动上去还能看到版本号。这些信息由我们如下的代码定义：
|
||||
|
||||
```python
|
||||
mcp = FastMCP('锦恢的 MCP Server', version="11.45.14")
|
||||
```
|
||||
|
||||
这在我们进行版本管理的时候会非常有用。请善用这套系统。
|
||||
|
||||
|
||||
如果连接失败，可以点击左侧工具栏的第二个按钮，进入连接控制台，查看错误信息，或是手动调整连接命令：
|
||||
|
||||
<div align=center>
|
||||
<img src="https://pic1.zhimg.com/80/v2-684190b98dbbb9a7bf0e8c8048bd1277_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
### 初识 OpenMCP
|
||||
|
||||
接下来，我来简单介绍一下 OpenMCP 的基本功能模块，如果一开始，你的屏幕里什么也没有，先点击上面的加号创建一个新的标签页，此处页面中会出现下图屏幕中的四个按钮
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-3a4e8aa1ddaac632601532bb757a15ad_1440w.png?source=d16d100b" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
放大一点
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-ecc0705ed534e2cf0bc748ecd95f5f22_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
前三个，资源、提词和工具，分别用于调试 MCP 中的三个对应项目，也就是 Resources，Prompts 和 Tools，这三个部分的使用，基本和 MCP 官方的 Inspector 工具是一样的，那是自然，我就照着这几个抄的，诶嘿。
|
||||
|
||||
<div align=center>
|
||||
<img src="https://pica.zhimg.com/80/v2-d767e782f667161442ea183f55ca49b1_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
然后第四个按钮「交互测试」，它是一个我开发的 MCP 客户端，其实就是一个对话窗口，你可以无缝衔接地直接在大模型中测试你当前的 MCP 服务器的功能函数。
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-b59ee2d290e096343fb4659baf34cf57_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
|
||||
目前我暂时只支持 tools 的支持，因为 prompts 和 resources 的我还没有想好，（resource 感觉就是可以当成一个 tool），欢迎大家进群和我一起讨论：QQ群 782833642
|
||||
|
||||
|
||||
|
||||
## 开始调试天气函数
|
||||
|
||||
### 工具调试
|
||||
|
||||
还记得我们一开始给的 mcp 的例子吗？我们可以通过 OpenMCP 来快速调试这里面写的函数，比如我们本期的目标，写一个天气预报的 MCP，那么假设我们已经写好了一个天气预报的函数了，我们把它封装成一个 tool：
|
||||
|
||||
```python
|
||||
@mcp.tool(
|
||||
name='weather',
|
||||
description='获取指定城市的天气信息'
|
||||
)
|
||||
def get_weather(city: str) -> str:
|
||||
"""模拟天气查询协议，返回格式化字符串"""
|
||||
return f"Weather in {city}: Sunny, 25°C"
|
||||
```
|
||||
|
||||
当然，它现在是没有意义的，因为就算把黑龙江的城市ID输入，它也返回 25 度，但是这些都不重要，我想要带阁下先走完整套流程。建立自上而下的感性认知比死抠细节更加容易让用户学懂。
|
||||
|
||||
那么我们现在需要调试这个函数，打开 OpenMCP，新建一个「工具」调试项目
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-1c67ab54d67023e408413484768377cf_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
然后此时，你在左侧的列表可以看到 weather 这个工具，选择它，然后在右侧的输入框中随便输入一些东西，按下回车（或者点击「运行」），你能看到如下的响应：
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-d32a9c0d9fcab497dc03152a72c4c62b_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
看到我们函数 return 的字符串传过来了，说明没问题，链路通了。
|
||||
|
||||
### 交互测试
|
||||
|
||||
诶？我知道你编程很厉害，但是，在噼里啪啦快速写完天气预报爬虫前，我们现在看看我们要如何把已经写好的工具注入大模型对话中。为了使用大模型，我们需要先选择大模型和对应的 API，点击左侧工具栏的第三个按钮，进入 API 模块，选择你想要使用的大模型运营商、模型，填写 API token，然后点击下面的「保存」
|
||||
|
||||
<div align=center>
|
||||
<img src="https://pic1.zhimg.com/80/v2-367780b204d2aa50354585272b71af20_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
再新建一个标签页，选择「交互测试」，此时，我们就可以直接和大模型对话了，我们先看看没有任何工具注入的大模型会如何回应天气预报的问题，点击最下侧工具栏从左往右第三个按钮，进入工具选择界面，选择「禁用所有工具」
|
||||
|
||||
<div align=center>
|
||||
<img src="https://pic1.zhimg.com/80/v2-977a53ea14eae5e1a646fc73d379a422_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
点击「关闭」后，我们问大模型一个问题：
|
||||
|
||||
```
|
||||
请问杭州的温度是多少？
|
||||
```
|
||||
|
||||
<div align=center>
|
||||
<img src="https://pic1.zhimg.com/80/v2-d3aa56602f574a6968295f9a5c93438f_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
可以看到，大模型给出了和文章开头一样的回答。非常敷衍，因为它确实无法知道。
|
||||
|
||||
此处，我们再单独打开「weather」工具：
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-2ed66eaff604d11d52f60201fca215d4_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
问出相同的问题：
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-e934d386e20b1de43fb5e0dd426de86e_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
可以看到，大模型给出了回答是 25 度，还有一些额外的推导信息。
|
||||
|
||||
我们不妨关注一些细节，首先，大模型并不会直接回答问题，而是会先去调用 weather 这个工具，调用参数为：
|
||||
|
||||
```json
|
||||
{
|
||||
"city": "杭州"
|
||||
}
|
||||
```
|
||||
|
||||
然后，我们的 MCP 服务器给出了响应：
|
||||
|
||||
```
|
||||
Weather in 杭州: Sunny, 25°C
|
||||
```
|
||||
|
||||
从而，最终大模型才根据这些信息给出了最终的回答。也就是，这个过程我们实际调用了两次大模型的服务。而且可以看到两次调用的输入 token 数量都非常大，这是因为 OpenMCP 会将函数调用以 JSON Schema 的形式注入到请求参数中，weather 这个工具的 JSON Schema 如下图的右侧的 json 所示：
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-2ed66eaff604d11d52f60201fca215d4_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
然后支持 openai 协议的大模型厂商都会针对这样的信息进行 function calling，所以使用了工具的大模型请求的输入 token 数量都会比较大。但是不需要担心，大部分厂商都实现了 KV Cache，对相同前缀的输入存在缓存，缓存命中部分的费用开销是显著低于普通的 输入输出 token 价格的。OpenMCP 在每个回答的下面都表明了当次请求的 输入 token，输出 token，总 token 和 缓存命中率。
|
||||
|
||||
其中
|
||||
|
||||
- 「总 token」 = 「输入 token」 + 「输出 token」
|
||||
|
||||
- 「缓存命中率」 = 「缓存命令的 token」 / 「输入 token」
|
||||
|
||||
> 没错，缓存命中率 是对于输入 token 的概念，输出 token 是没有 缓存命中率这个说法的。
|
||||
|
||||
在后续的开发中，你可以根据这些信息来针对性地对你的服务或者 prompt 进行调优。
|
||||
|
||||
### 完成一个真正的天气预报吧！
|
||||
|
||||
当然，这些代码也非常简单，直接让大模型生成就行了（其实大模型是无法生成免 API 的 python 获取天气的代码的，我是直接让大模型把我个人网站上天气预报的 go 函数翻译了一下）
|
||||
|
||||
我直接把函数贴上来了：
|
||||
|
||||
```python
|
||||
import requests
|
||||
import json
|
||||
from typing import NamedTuple, Optional
|
||||
|
||||
class CityWeather(NamedTuple):
|
||||
city_name_en: str
|
||||
city_name_cn: str
|
||||
city_code: str
|
||||
temp: str
|
||||
wd: str
|
||||
ws: str
|
||||
sd: str
|
||||
aqi: str
|
||||
weather: str
|
||||
|
||||
def get_city_weather_by_city_name(city_code: str) -> Optional[CityWeather]:
|
||||
"""根据城市名获取天气信息"""
|
||||
|
||||
if not city_code:
|
||||
print(f"找不到{city_code}对应的城市")
|
||||
return None
|
||||
|
||||
try:
|
||||
# 构造请求URL
|
||||
url = f"http://d1.weather.com.cn/sk_2d/{city_code}.html"
|
||||
|
||||
# 设置请求头
|
||||
headers = {
|
||||
"User-Agent": "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/115.0.0.0 Safari/537.36 Edg/115.0.0.0",
|
||||
"Host": "d1.weather.com.cn",
|
||||
"Referer": "http://www.weather.com.cn/"
|
||||
}
|
||||
|
||||
# 发送HTTP请求
|
||||
response = requests.get(url, headers=headers)
|
||||
response.raise_for_status()
|
||||
|
||||
# 解析JSON数据
|
||||
# 解析JSON数据前先处理编码问题
|
||||
content = response.text.encode('latin1').decode('unicode_escape')
|
||||
json_start = content.find("{")
|
||||
json_str = content[json_start:]
|
||||
|
||||
weather_data = json.loads(json_str)
|
||||
|
||||
# 构造返回对象
|
||||
return CityWeather(
|
||||
city_name_en=weather_data.get("nameen", ""),
|
||||
city_name_cn=weather_data.get("cityname", "").encode('latin1').decode('utf-8'),
|
||||
city_code=weather_data.get("city", ""),
|
||||
temp=weather_data.get("temp", ""),
|
||||
wd=weather_data.get("wd", "").encode('latin1').decode('utf-8'),
|
||||
ws=weather_data.get("ws", "").encode('latin1').decode('utf-8'),
|
||||
sd=weather_data.get("sd", ""),
|
||||
aqi=weather_data.get("aqi", ""),
|
||||
weather=weather_data.get("weather", "").encode('latin1').decode('utf-8')
|
||||
)
|
||||
|
||||
except Exception as e:
|
||||
print(f"获取天气信息失败: {str(e)}")
|
||||
return None
|
||||
|
||||
from mcp.server.fastmcp import FastMCP
|
||||
|
||||
mcp = FastMCP('weather', version="0.0.1")
|
||||
|
||||
@mcp.tool(
|
||||
name='get_weather_by_city_code',
|
||||
description='根据城市天气预报的城市编码 (int)，获取指定城市的天气信息'
|
||||
)
|
||||
def get_weather_by_code(city_code: int) -> str:
|
||||
"""模拟天气查询协议，返回格式化字符串"""
|
||||
city_weather = get_city_weather_by_city_name(city_code)
|
||||
return str(city_weather)
|
||||
```
|
||||
|
||||
|
||||
这里有几个点一定要注意：
|
||||
|
||||
1. 如果你的输入参数是数字，就算是城市编码这种比较长的数字，请一定定义成 int，因为 mcp 底层的是要走 JSON 正反序列化的，而 "114514" 这样的字符串会被 JSON 反序列化成 114514，而不是 "114514" 这个字符串。你实在要用 str 来表示一个很长的数字，那么就在前面加一个前缀，比如 "code-114514"，避免被反序列化成数字，从而触发 mcp 内部的 type check error
|
||||
2. tool 的 name 请按照 python 的变量命名要求进行命名，否则部分大模型厂商会给你报错。
|
||||
|
||||
好，我们先测试一下：
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-d2dbe925010b676482ee57258c14fca7_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
可以看到，我们的天气查询工具已经可以正常工作了。
|
||||
|
||||
那么接下来，我们就可以把这个工具注入到大模型中了。点击 「交互测试」，只激活当前这个工具，然后询问大模型：
|
||||
```
|
||||
请问杭州的天气是多少？
|
||||
```
|
||||
|
||||
<div align=center>
|
||||
<img src="https://picx.zhimg.com/80/v2-e581c6461190b358adda50ce83633520_1440w.png" style="width: 100%;"/>
|
||||
</div>
|
||||
|
||||
完美！
|
||||
|
||||
如此，我们便完成了一个天气查询工具的开发。并且轻松地注入到了我们的大模型中。在实际提供商业级部署方案的时候，虽然 mcp 目前的 stdio 冷启动速度足够快，但是考虑到拓展性等多方面因素，SSE 还是我们首选的连接方案，关于 SSE 的使用，我们下期再聊。
|
||||
|
||||
OpenMCP 开源链接：https://github.com/LSTM-Kirigaya/openmcp-client
|
||||
27
en/plugin-tutorial/faq/help.md
Normal file
27
en/plugin-tutorial/faq/help.md
Normal file
@ -0,0 +1,27 @@
|
||||
---
|
||||
layout: doc
|
||||
---
|
||||
|
||||
# 常见问题解答
|
||||
|
||||
## 错误代码说明
|
||||
|
||||
### 32000 - MCP 连接失败
|
||||
|
||||
MCP 连接失败可能有多种原因，以下是一些常见情况：
|
||||
|
||||
• **虚拟环境路径不匹配**
|
||||
|
||||
虚拟环境（venv）与入口文件路径不匹配是导致连接失败的常见原因之一。
|
||||
|
||||
详细的解决方案请参考：[配置说明](./venv-not-same-path/venv-not-same-path.md)
|
||||
|
||||
---
|
||||
|
||||
• **其他可能的原因**
|
||||
|
||||
- 端口被占用
|
||||
- 环境变量配置错误
|
||||
- 依赖库未正确安装
|
||||
|
||||
> 如果您遇到以上问题，请先查看错误日志获取详细信息。如果问题仍然存在，可以在 [GitHub Issues](https://github.com/LSTM-Kirigaya/openmcp-client/issues) 中寻求帮助。
|
||||
BIN
en/plugin-tutorial/faq/venv-not-same-path/image-2.png
Normal file
BIN
en/plugin-tutorial/faq/venv-not-same-path/image-2.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 71 KiB |
BIN
en/plugin-tutorial/faq/venv-not-same-path/image.png
Normal file
BIN
en/plugin-tutorial/faq/venv-not-same-path/image.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 21 KiB |
@ -0,0 +1,29 @@
|
||||
# 虚拟环境与入口文件不在同一目录时的配置方式
|
||||
|
||||
## 问题描述
|
||||
|
||||
在使用 OpenMCP 时，有时会遇到虚拟环境（venv）与 Python 文件不在同一目录的情况，甚至虚拟环境可能位于项目文件夹之外。这种情况下，点击右上角连接按钮可能会出现 MCP 连接失败（错误代码：32000）的问题。
|
||||
|
||||
## 解决方案
|
||||
|
||||
### 1. 调整执行目录
|
||||
|
||||
在连接选项中，您需要调整执行目录到虚拟环境所在的位置：
|
||||
|
||||
|
||||
|
||||
### 2. 修改执行命令
|
||||
|
||||
同时，需要相应地修改执行命令：
|
||||
|
||||
|
||||
|
||||
### 3. 直接指定解释器路径
|
||||
|
||||
对于特定情况，您可以直接在命令中指定 Python 解释器的完整路径，例如：
|
||||
|
||||
```bash
|
||||
C:\code\ygo-chat\.venv\Scripts\python.exe example.py
|
||||
```
|
||||
|
||||
> 注意：此方法同样适用于 node或者mcp指令的【命令】以及其它mcp client的mcp配置文件。
|
||||
BIN
en/plugin-tutorial/images/inspector.png
Normal file
BIN
en/plugin-tutorial/images/inspector.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 389 KiB |
BIN
en/plugin-tutorial/images/openmcp.png
Normal file
BIN
en/plugin-tutorial/images/openmcp.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 624 KiB |
43
en/plugin-tutorial/index.md
Normal file
43
en/plugin-tutorial/index.md
Normal file
@ -0,0 +1,43 @@
|
||||
---
|
||||
next:
|
||||
text: 什么是 MCP？
|
||||
link: '/plugin-tutorial/what-is-mcp'
|
||||
---
|
||||
|
||||
# OpenMCP 概述
|
||||
|
||||
:::warning
|
||||
在正式开始 OpenMCP 的学习之前，我们强烈推荐您先了解一下 MCP 的基本概念：[Agent 时代基础设施 | MCP 协议介绍](https://kirigaya.cn/blog/article?seq=299)
|
||||
:::
|
||||
|
||||
## 什么是 OpenMCP
|
||||
|
||||
OpenMCP 是一个面向开发者的 MCP 调试器和 SDK，致力于降低 AI Agent 的全链路开发成本和开发人员的心智负担。
|
||||
|
||||
|
||||
|
||||
OpenMCP 分为两个部分，但是本板块讲解的是 OpenMCP 调试器的部分的使用，这部分也被我们称为 OpenMCP Client。OpenMCP Client 的本体是一个可在类 vscode 编辑器上运行的插件。它兼容了目前 MCP 协议的全部特性，且提供了丰富的利于开发者使用的功能，可以作为 Claude Inspector 的上位进行使用。
|
||||
|
||||
:::info 类 vscode 编辑器 (VLE)
|
||||
类 vscode 编辑器 (vscode-like editor，简称 VLE) 是指基于 Vscodium 内核开发的通用型代码编辑器，它们都能够兼容的大部分的vscode插件生态，并且具有类似 vscode 的功能（比如支持 LSP3.7 协议、拥有 remote ssh 进行远程开发的能力、拥有跨编辑器的配置文件）。
|
||||
|
||||
比较典型的 VLE 有：vscode, trae, cursor 和 vscodium 各类发行版本。
|
||||
:::
|
||||
|
||||
## 什么是 Claude Inspector
|
||||
|
||||
Claude Inspector 是一款 Claude 官方（也就是 MCP 协议的提出者）发布的开源 MCP 调试器，开发者在开发完 MCP 服务器后，可以通过这款调试器来测试功能完整性。
|
||||
|
||||
|
||||
|
||||
但是 Inspector 工具存在如下几个缺点：
|
||||
|
||||
- 使用麻烦：使用 Inspector 每次都需要通过 mcp dev 启动一个 web 前后端应用
|
||||
- 功能少：Inspector 只提供了最为基础的 MCP 的 tool 等属性的调试。如果用户想要测试自己开发的 MCP 服务器在大模型的交互下如何，还需要连接进入 Claude Desktop 并重启客户端，对于连续调试场景，非常不方便。
|
||||
- 存在部分 bug：对于 SSE 和 streamable http 等远程连接的场景，Inspector 存在已知 bug，这对真实工业级开发造成了极大的影响。
|
||||
- 无法对调试内容进行保存和留痕：在大规模微服务 mcp 化的项目中，这非常重要。
|
||||
- 无法同时调试多个 mcp 服务器：在进行 mcp 原子化横向拓展的场景中，这是一项必要的功能。
|
||||
|
||||
而 OpenMCP Client 被我们制作出来的一个原因就是为了解决 Inspector 上述的痛点，从而让 mcp 服务器的开发门槛更低，用户能够更加专注于业务本身。
|
||||
|
||||
<!-- -->
|
||||
61
en/plugin-tutorial/quick-start/acquire-openmcp.md
Normal file
61
en/plugin-tutorial/quick-start/acquire-openmcp.md
Normal file
@ -0,0 +1,61 @@
|
||||
---
|
||||
layout: doc
|
||||
---
|
||||
|
||||
|
||||
# 获取 OpenMCP
|
||||
|
||||
## 在插件商城中安装 OpenMCP
|
||||
|
||||
你可以在主流 VLE 的插件商城直接获取 OpenMCP 插件。比如在 vscode 中，点击左侧的插件商城，然后在搜索框中输入 `OpenMCP` 即可找到 OpenMCP 插件。
|
||||
|
||||
|
||||
|
||||
## 离线安装
|
||||
|
||||
VLE 的插件本质是一个 zip 压缩包，后缀名为 vsix，全平台通用。我们的 CI/CD 机器人在每次版本发布后，会自动构建并上传 vsix 到 github release，你可以通过如下的链接访问到对应版本的 github release 页面：
|
||||
|
||||
```
|
||||
https://github.com/LSTM-Kirigaya/openmcp-client/releases/tag/v{版本号}
|
||||
```
|
||||
|
||||
比如对于 0.1.1 这个版本，它的 release 页面链接为：[https://github.com/LSTM-Kirigaya/openmcp-client/releases/tag/v0.1.1](https://github.com/LSTM-Kirigaya/openmcp-client/releases/tag/v0.1.1)
|
||||
|
||||
在 `Assets` 下面，你可以找到对应的 vsix 压缩包
|
||||
|
||||
|
||||
|
||||
除此之外，您还可以通过如下的商城网页来获取最新的 openmcp 的 vsix
|
||||
|
||||
- https://open-vsx.org/extension/kirigaya/openmcp
|
||||
- https://marketplace.visualstudio.com/items?itemName=kirigaya.openmcp
|
||||
|
||||
点击 vsix 后缀名的文件下载，下载完成后，您就可以直接安装它了。在 VLE 中安装外部的 vsix 文件有两种方法。
|
||||
|
||||
### 方法一：在 VLE 中安装
|
||||
|
||||
VLE 的插件商城页面有一个三个点的按钮，点击它后，你能看到下面这个列表中被我标红的按钮
|
||||
|
||||
|
||||
|
||||
点击它后，找到刚刚下载的 vsix 文件，点击即可完成安装。
|
||||
|
||||
### 方法二：通过命令行
|
||||
|
||||
如果您的 VLE 是全局安装的，会自动存在一个命令行工具，命令如下：
|
||||
|
||||
::: code-group
|
||||
```bash [vscode]
|
||||
code --install-extension /path/to/openmcp-0.1.1.vsix
|
||||
```
|
||||
|
||||
```bash [trae]
|
||||
trae --install-extension /path/to/openmcp-0.1.1.vsix
|
||||
```
|
||||
|
||||
```bash [cursor]
|
||||
cursor --install-extension /path/to/openmcp-0.1.1.vsix
|
||||
```
|
||||
:::
|
||||
|
||||
`/path/to/openmcp-0.1.1.vsix` 代表你刚刚下载的 vsix 文件的绝对路径。这样也可以安装插件。
|
||||
140
en/plugin-tutorial/quick-start/first-mcp.md
Normal file
140
en/plugin-tutorial/quick-start/first-mcp.md
Normal file
@ -0,0 +1,140 @@
|
||||
|
||||
# 你的第一个 MCP
|
||||
|
||||
实现 MCP 的编程语言很多，常见的几户所有编程语言都有官方和民间的支持，以 编程语言 + MCP 就能搜到对应的库，在 [[mcp-examples|MCP 服务器开发案例]] 中，我们也提供了不同编程语言的不同例子。
|
||||
|
||||
在所有编程语言中，Python 的 MCP 的开发无疑是最为简单，最容易让新手上手的，所以第一个 MCP我们先用 python 来实现。其他的编程语言实现效果也大同小异。
|
||||
|
||||
## 安装 uv
|
||||
|
||||
Python 写 mcp 服务器强烈推荐使用 uv 作为包管理器，关于 uv，你只需要知道它是一个高性能包管理器，拥有 pip 和 conda 的所有优点。没有的朋友请先通过 pip 安装 uv：
|
||||
|
||||
|
||||
```bash
|
||||
pip install uv
|
||||
```
|
||||
|
||||
|
||||
:::warning 使用 anaconda 或者 miniconda 的朋友注意了！
|
||||
请不要在非 base 环境下安装 uv，请在 base 环境下安装 uv，uv 本身会做好环境隔离的工作，请不要担心 uv 会污染你的 base 环境。你不安装在 base 下或者使用全局默认的 pip 安装，我们根本不知道你安装的 uv 在哪里！base 环境下使用 pip 安装的脚本会安装在 `~/anaconda/bin/uv` 中，也请确保 `~/anaconda/bin/` 在你的 `$PATH` 中。
|
||||
:::
|
||||
|
||||
|
||||
查看 uv 的版本：
|
||||
|
||||
```bash
|
||||
uv version
|
||||
```
|
||||
|
||||
我的输出是：
|
||||
```
|
||||
uv 0.6.9 (3d9460278 2025-03-20)
|
||||
```
|
||||
|
||||
实操时，请保证版本不要低于我的。
|
||||
|
||||
## 创建一个最简单的 mcp 服务器
|
||||
|
||||
我们进入工程目录，准备创建一个最简单的 mcp 服务器。
|
||||
|
||||
```bash
|
||||
mkdir -p ~/codes/my-first-mcp
|
||||
cd ~/codes/my-first-mcp
|
||||
uv init --no-workspace
|
||||
```
|
||||
|
||||
此时，你的项目里面应该有这三个文件：
|
||||
|
||||
```
|
||||
README.md main.py pyproject.toml
|
||||
```
|
||||
|
||||
然后，我们在当前文件夹打开 vscode 或者 trae，我们创建一个最简单的 mcp 服务器，它的功能是：
|
||||
- 提供一个名为 add 的工具，用于对两个数字进行加法
|
||||
- 提供一个名为 greeting 的资源，用于返回一个 greeting 消息
|
||||
|
||||
先安装 mcp 相关的库：
|
||||
|
||||
```bash
|
||||
uv add mcp "mcp[cli]"
|
||||
```
|
||||
|
||||
修改 `main.py` 内容如下：
|
||||
|
||||
```python
|
||||
from mcp.server.fastmcp import FastMCP
|
||||
mcp = FastMCP('锦恢的 MCP Server', version="11.45.14")
|
||||
|
||||
@mcp.tool(
|
||||
name='add',
|
||||
description='对两个数字进行实数域的加法'
|
||||
)
|
||||
def add(a: int, b: int) -> int:
|
||||
return a + b
|
||||
|
||||
@mcp.resource(
|
||||
uri="greeting://{name}",
|
||||
name='greeting',
|
||||
description='用于演示的一个资源协议'
|
||||
)
|
||||
def get_greeting(name: str) -> str:
|
||||
return f"Hello, {name}!"
|
||||
|
||||
@mcp.prompt(
|
||||
name='translate',
|
||||
description='进行翻译的prompt'
|
||||
)
|
||||
def translate(message: str) -> str:
|
||||
return f'请将下面的话语翻译成中文：\n\n{message}'
|
||||
```
|
||||
|
||||
## 使用 OpenMCP 一键连接
|
||||
|
||||
如上，我们申明了三个函数，用作 mcp 的 tool，resource 和 prompt。在 OpenMCP 中启动它们非常简单，点击右上角的 OpenMCP 图标即可连接：
|
||||
|
||||
|
||||
|
||||
初次使用 OpenMCP，会出现引导界面，还希望阁下可以耐心看完。
|
||||
|
||||
|
||||
|
||||
如果登录完成后，如图显示连接成功，则代表当前已经成功启动并连接 mcp 服务器。
|
||||
|
||||
|
||||
|
||||
恭喜您，万事开头难，您已经完成了最难的 mcp 连接！
|
||||
|
||||
有关 openmcp 进行 mcp 服务器连接的更多信息，可以参考手册里面的这一章 [[connect-mcp|连接到 MCP 服务器]]。
|
||||
|
||||
## 附录：关于 uv 启动 mcp 你必须知道的
|
||||
|
||||
OpenMCP 已经帮你做好了很多事情，但是使用 uv 启动 mcp 服务器其实是不只一种方法的，了解更加底层的原理有助于您以不变应万变。因为 OpenMCP 对于 python 项目默认运行 `uv run mcp run main.py` 来启动 mcp 服务器，但是 GitHub 上的部分项目无法这么启动。
|
||||
|
||||
先了解一下对于上面那个例子的 python 代码，应该如何通过命令行启动 mcp 吧！
|
||||
|
||||
### 方法一：使用 mcp-cli
|
||||
|
||||
mcp 本身提供了脚手架，可以直接启动一段被申明的 python 代码，作为一个 mcp 服务器。使用如下代码运行它：
|
||||
|
||||
```bash
|
||||
uv run mcp run main.py
|
||||
```
|
||||
|
||||
### 方法二：在代码中显式启动
|
||||
|
||||
你也可以在代码中显式启动 mcp 服务器，在 `main.py` 的结尾添加：
|
||||
|
||||
```python
|
||||
if __name__ == '__main__':
|
||||
mcp.run()
|
||||
```
|
||||
|
||||
然后运行如下代码即可启动 mcp 服务器：
|
||||
|
||||
```bash
|
||||
uv run main.py
|
||||
```
|
||||
|
||||
:::warning
|
||||
请不要运行 python main.py，因为 uv run 会使用当前虚拟环境的库，这些库在外部 python 看来是不可见的。也不要在没有使用 `mcp.run()` 启动代码的情况下就直接使用 uv run main.py，我们之前的代码只是申明了函数，并没有实际上执行任何功能。
|
||||
:::
|
||||
BIN
en/plugin-tutorial/quick-start/images/bing-image-common.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/bing-image-common.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 160 KiB |
BIN
en/plugin-tutorial/quick-start/images/connect-simple.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/connect-simple.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 511 KiB |
BIN
en/plugin-tutorial/quick-start/images/connect-success.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/connect-success.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 394 KiB |
BIN
en/plugin-tutorial/quick-start/images/github-release.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/github-release.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 228 KiB |
BIN
en/plugin-tutorial/quick-start/images/guide.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/guide.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 428 KiB |
BIN
en/plugin-tutorial/quick-start/images/image.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/image.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 133 KiB |
BIN
en/plugin-tutorial/quick-start/images/inspector.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/inspector.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 389 KiB |
BIN
en/plugin-tutorial/quick-start/images/llm-bing-image-render.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/llm-bing-image-render.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 1.2 MiB |
BIN
en/plugin-tutorial/quick-start/images/llm-calc.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/llm-calc.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 232 KiB |
BIN
en/plugin-tutorial/quick-start/images/llm-intro.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/llm-intro.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 228 KiB |
BIN
en/plugin-tutorial/quick-start/images/llm-tools.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/llm-tools.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 289 KiB |
BIN
en/plugin-tutorial/quick-start/images/openmcp-home.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/openmcp-home.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 386 KiB |
BIN
en/plugin-tutorial/quick-start/images/openmcp.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/openmcp.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 624 KiB |
BIN
en/plugin-tutorial/quick-start/images/rerun-bing-image.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/rerun-bing-image.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 116 KiB |
BIN
en/plugin-tutorial/quick-start/images/resource-desc.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/resource-desc.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 423 KiB |
BIN
en/plugin-tutorial/quick-start/images/resource-result.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/resource-result.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 440 KiB |
BIN
en/plugin-tutorial/quick-start/images/system-prompt-add.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/system-prompt-add.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 139 KiB |
BIN
en/plugin-tutorial/quick-start/images/system-prompt-image.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/system-prompt-image.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 175 KiB |
BIN
en/plugin-tutorial/quick-start/images/tool-add-test-project.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/tool-add-test-project.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 425 KiB |
BIN
en/plugin-tutorial/quick-start/images/tool-desc.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/tool-desc.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 466 KiB |
BIN
en/plugin-tutorial/quick-start/images/tool-result.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/tool-result.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 118 KiB |
Binary file not shown.
|
After Width: | Height: | Size: 213 KiB |
BIN
en/plugin-tutorial/quick-start/images/vscode-plugin-market.png
Normal file
BIN
en/plugin-tutorial/quick-start/images/vscode-plugin-market.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 467 KiB |
11
en/plugin-tutorial/quick-start/index.md
Normal file
11
en/plugin-tutorial/quick-start/index.md
Normal file
@ -0,0 +1,11 @@
|
||||
# 快速开始
|
||||
|
||||
1. [[acquire-openmcp|获取 OpenMCP]]
|
||||
|
||||
2. [[first-mcp|你的第一个 MCP]]
|
||||
3. [[quick-debug|快速调试 MCP]]
|
||||
4. [[put-into-llm|扔进大模型里面测测好坏！]]
|
||||
|
||||
|
||||
<br>
|
||||
<br>
|
||||
65
en/plugin-tutorial/quick-start/put-into-llm.md
Normal file
65
en/plugin-tutorial/quick-start/put-into-llm.md
Normal file
@ -0,0 +1,65 @@
|
||||
# 扔进大模型里面测测好坏！
|
||||
|
||||
在 [[quick-debug|之前的章节]] 中，我们成功完成了 mcp 服务器的连接和各个功能的调试，也算是带大家认识了一下 openmcp 的基本调试功能。接下来，我们需要把 mcp 放到大模型环境中来测试，毕竟，mcp 提出的初衷就是为了让大家可以低成本把自己写的功能接入大模型中。
|
||||
|
||||
在正式进行对话前，还请大家先参照 [[connect-llm|连接大模型]] 来完成大模型 API 的配置，并测试完成你的大模型服务是否可用。
|
||||
|
||||
## 和大模型进行对话
|
||||
|
||||
我们先创建一个新的调试项目，选择「交互测试」，就可以进入一个和大模型对话的窗口。OpenMCP 提供的对话窗口的基本介绍如下：
|
||||
|
||||
|
||||
|
||||
上面标定了几个比较重要的按钮，初次使用，您可以直接使用默认设置。点击「使用的工具」，可以看到当前激活的工具，OpenMCP 默认激活当前连接的 mcp 服务器的所有提供的工具，如果您希望禁用某些工具，可以点击下方的「使用的工具」来选择性地禁用工具：
|
||||
|
||||
|
||||
|
||||
好啦，让我们先来看看基于 mcp 协议，大模型会如何调用我们的工具吧，保持默认设置，然后询问如下问题：<mark>请帮我计算一下 123 + 1313 等于多少</mark>
|
||||
|
||||
输入后回车等待结果，可以看到如下的输出：
|
||||
|
||||
|
||||
|
||||
可以看到大模型选择使用了我们提供的工具 add 完成了上述的加法，OpenMCP 中你能看到大模型是如何调用每一个工具的和工具的返回结果。目前我们问的问题和 mcp 提供的工具都比较简单，对于复杂问题，大模型有可能会在一轮内同时调用多个工具来完成特定的任务，如果你希望大模型每次都只使用一个工具，可以点击下方的默认亮着的「允许模型在单轮回复中调用多个工具」 来禁用这个特性。
|
||||
|
||||
|
||||
## 系统提示词
|
||||
|
||||
对于一些特殊的情况，比如 [bing-images](/Users/bytedance/projects/openmcp-tutorial/bing-images)，这是一个根据关键词来返回 bing 图片的 mcp 服务器。
|
||||
|
||||
我们直接询问如下的问题：<mark>请帮我搜索几张明日方舟的图片</mark>，默认情况下，你有可能会得到如下的回复：
|
||||
|
||||
|
||||
|
||||
大模型将得到的图片以链接的形式返回了，但是有的时候其实我希望是返回成图片的形式渲染在屏幕中让我看到的，为了约束和引导大模型返回文本的风格、或是按照我们要求的模板进行返回，我们可以通过设置系统提示词的方式来实现。
|
||||
|
||||
我们先点击下方的「系统提示词」
|
||||
|
||||
|
||||
|
||||
我们添加一个新的系统提示词，在标题输入「bing image」，然后主体部分填入：
|
||||
|
||||
```
|
||||
你是一个擅长找 bing 图片的 AI，当你找到图片时，你应该返回图片形式的 markdown，比如 
|
||||
```
|
||||
|
||||
点击保存。
|
||||
|
||||
|
||||
|
||||
然后将光标移动到第一个用户对话框上，此时会显示几个按钮，选择重新运行的按钮，openmcp 便会重新执行此处的对话。
|
||||
|
||||
|
||||
|
||||
可以看到此时，图片就被正常渲染出来了：
|
||||
|
||||
|
||||
|
||||
|
||||
关于更多使用 system prompt 或者其他更加精准的方法来控制 agent 的技巧，可以移步 [[go-neo4j-sse|go 实现 neo4j 的只读 mcp 服务器 (SSE)]]
|
||||
|
||||
## 结语
|
||||
|
||||
很好！你完成了 openmcp 的基础教程，接下来，该去做点有趣的事情了！在 [[mcp-examples|MCP 服务器开发案例]] 中，你能找到更多的使用 openmcp 进行 mcp 服务器开发的例子。
|
||||
|
||||
遍地惊喜，任君自取。
|
||||
49
en/plugin-tutorial/quick-start/quick-debug.md
Normal file
49
en/plugin-tutorial/quick-start/quick-debug.md
Normal file
@ -0,0 +1,49 @@
|
||||
# 快速调试 MCP
|
||||
|
||||
在 [[first-mcp|你的第一个 MCP]] 中，我们成功创建了一个 MCP 服务器的最小实例，并且成功使用 openmcp 连接了这个服务器。
|
||||
|
||||
接下来，我们可以来调试这个服务器的功能了，毕竟，不是所有人都是 Jeaf Dean，都能一次就写对所有代码。我们写的 MCP 服务器也不总是一开始就自信满满可以上线的，它总是存在着一些我们无法发现的问题。试想一下，如果后面我们把 mcp 连接到大模型进行全链路调试时出了问题，这个时候你就会发现，可能出错的环节非常多：MCP 服务器的问题？大模型厂商的问题？OpenMCP 的问题？把可能的错误进行分类，然后逐一排查，才是符合工程直觉 (Engineering Instuition) 的做法。
|
||||
|
||||
## 认识面板
|
||||
|
||||
首次进入 openmcp 时，会进入一个面板，上面一共四个按钮，代表四种调试项目：
|
||||
|
||||
|
||||
|
||||
我们现在需要确认的是 tool，resource 和 prompt 这三个功能是否运行正常，因为在实际项目中，tool 是使用得最多的项目，因此，我们先调试 tool。
|
||||
|
||||
## 调试 Tool
|
||||
|
||||
为了调试 tool，我们点击面板上的 「工具」 按钮，进入 tool 调试界面。tool 面板的基本介绍如下所示
|
||||
|
||||
|
||||
|
||||
调试工具，我们需要先在「工具列表」中选择一个工具（如果没有展开需要先展开工具列表，点击右侧的按钮可以刷新），然后在右侧的「参数填写和执行」中，填写需要测试的参数，点击运行，就能看到结果了：
|
||||
|
||||
|
||||
|
||||
比如我们这边运算最简单的 2 + 2，可以看到结果是 4，这说明我们的 mcp 连接正常还可以正常返回结果。大家未来可以通过简单测试来验证 mcp 服务器的可用性，这在复杂 agent 系统的调试过程中非常重要。可以编码成自检程序的一部分。
|
||||
|
||||
## 添加测试项目
|
||||
|
||||
测试完成一个项目后，我们可以通过点击上方的 + 来添加额外的测试项目：
|
||||
|
||||
|
||||
|
||||
这里，我们选择「资源」来进行资源项目的调试工作，「资源」和另外两个项目有点不一样，MCP 协议中的资源访问有两种类型
|
||||
|
||||
- resources/templates/list: 模板资源，带有访问参数，比如文件系统 mcp 中的文件访问，输入文件路径，根据资源协议返回文件内容。
|
||||
- resources/list：普通资源，不带访问参数，比如浏览器 mcp 中的 console，直接返回控制台的 stdio，这种就不需要参数。
|
||||
|
||||
|
||||
|
||||
|
||||
`resources/templates/list` 的使用方法和之前的 tool 一样，填入参数点击运行就能看到资源结果
|
||||
|
||||
|
||||
|
||||
而 `resources/list` 由于没有参数，直接点击左侧的资源就能直接看到内部的数据。
|
||||
|
||||
## 总结
|
||||
|
||||
在这一章节中，我们主要介绍了如何使用 openmcp 来调试 MCP 服务器，包括如何调试 tool 和 resource，prompt 的方法和这两个类似，大家可以自行尝试。下一章中，我们将开启最激动人心的一章，我们将把开发的 mcp 服务器扔到大模型中进行测试，这样你才知道你写的 mcp 是不是真的好玩，是不是有价值。
|
||||
69
en/plugin-tutorial/usage/connect-llm.md
Normal file
69
en/plugin-tutorial/usage/connect-llm.md
Normal file
@ -0,0 +1,69 @@
|
||||
# 连接大模型
|
||||
|
||||
如果需要使用「交互测试」来在和大模型的交互中测试 MCP 工具的性能，你需要首先需要在 OpenMCP 配置大模型。
|
||||
|
||||
:::warning 协议兼容性警告
|
||||
目前 OpenMCP 只支持符合 OpenAI 接口规范的 大模型服务，其他大模型的调用需要请通过 [newApi](https://github.com/QuantumNous/new-api) 进行转发或者自行实现。
|
||||
|
||||
目前市面上主流的如下模型我们都是支持的，如果遇到大模型连接的问题，请随时 [[channel|联系我们]]。
|
||||
:::
|
||||
|
||||
在 「设置」-「API」 可以进入大模型的连接配置界面。
|
||||
|
||||
|
||||
|
||||
## 默认支持的模型
|
||||
|
||||
OpenMCP 默认填充了市面上常见的大模型，下面是支持的模型
|
||||
|
||||
| 大模型 Name | 提供商 | baseUrl | 默认模型 |
|
||||
|----------------------|---------------------------|---------------------------------------------|-----------------------|
|
||||
| DeepSeek | DeepSeek | `https://api.deepseek.com/v1` | `deepseek-chat` |
|
||||
| OpenAI | OpenAI | `https://api.openai.com/v1` | `gpt-4-turbo` |
|
||||
| 通义千问 Qwen | Alibaba | `https://dashscope.aliyuncs.com/compatible-mode/v1` | `qwen-plus` |
|
||||
| 豆包 Seed | ByteDance | `https://ark.cn-beijing.volces.com/api/v3` | `doubao-1.5-pro-32k` |
|
||||
| Gemini | Google | `https://generativelanguage.googleapis.com/v1beta/openai/` | `gemini-2.0-flash` |
|
||||
| Grok | xAI | `https://api.x.ai/v1` | `grok-3-mini` |
|
||||
| Mistral | Mistral AI | `https://api.mistral.ai/v1` | `mistral-tiny` |
|
||||
| Groq | Groq | `https://api.groq.com/openai/v1` | `mixtral-8x7b-32768` |
|
||||
| Perplexity | Perplexity AI | `https://api.perplexity.ai/v1` | `pplx-7b-online` |
|
||||
| Kimi Chat | 月之暗面 (Moonshot AI) | `https://api.moonshot.cn/v1` | `moonshot-v1-8k` |
|
||||
|
||||
|
||||
## 配置大模型
|
||||
|
||||
你需要做的只是把对应服务商的 apiToken 填入 openmcp 中即可。然后点击「测试」，看到下面的响应说明连接成功。您就可以在交互测试里面使用大模型了！
|
||||
|
||||
|
||||
|
||||
:::warning
|
||||
有些用户会遇到无法访问的问题，请确保你的 baseUrl 填写正确。如果在国内使用某些国外厂商的服务，比如 gemini，openai，请确保你的网络环境可以访问到这些服务。在 「设置」-「通用」中你可以设置代理服务器。
|
||||
:::
|
||||
|
||||
|
||||
## 添加模型
|
||||
|
||||
如果你想使用的指定服务商的模型不在默认支持的模型中，有两种方法可以添加它们。
|
||||
|
||||
### 方法一：更新模型列表
|
||||
|
||||
此处以通义千问为例子，确保在 apitoken 填写正确的情况下，点击「更新模型列表」，如果服务商严格实现了 openai 标准，那么就能看到所有更新的模型了。
|
||||
|
||||
|
||||
|
||||
### 方法二：手动添加模型
|
||||
|
||||
如果你的服务器没有支持 openai 标准，你将无法使用「方法一」，你可以如此手动添加模型列表。此处以 Grok 为例，在服务商中找到 grok，点击图中所示的编辑
|
||||
|
||||
|
||||
|
||||
点击模型，输入模型名称，回车，点击确认：
|
||||
|
||||
|
||||
|
||||
|
||||
回到 api 页面，再点击保存。
|
||||
|
||||
## 添加服务
|
||||
|
||||
如果你要的服务商没有出现我们的列表中（云服务商的服务，或者自己部署的服务），可以通过「添加服务」按钮来添加自定义模型，使用方法和「添加模型」「方法二：手动添加模型」类似，就不赘述了。
|
||||
77
en/plugin-tutorial/usage/connect-mcp.md
Normal file
77
en/plugin-tutorial/usage/connect-mcp.md
Normal file
@ -0,0 +1,77 @@
|
||||
# 连接 mcp 服务器
|
||||
|
||||
不同于 Claude Desktop 和其他的 MCP 客户端类产品，OpenMCP 进行 MCP 服务器连接的步骤是相当丝滑的。
|
||||
|
||||
:::info MCP客户端
|
||||
MCP 客户端是指能够通过 MCP 协议进行通信的大模型对话客户端，通常是一个运行在本地的应用程序（因为网页没有文件IO的权限）。它的产品形式目前几乎都是聊天机器人的形式，类似于你在网页使用的 chat.deepseek.com 或者 chat.openai.com
|
||||
:::
|
||||
|
||||
首先，打开你的 VLE，在 [[acquire-openmcp|获取 OpenMCP]] 中完成 OpenMCP 的安装后，我们先用 python 创建一个最简单的 mcp 服务器，来测试 mcp 客户端的连接。
|
||||
|
||||
|
||||
## 使用 OpenMCP 一键连接
|
||||
|
||||
在 [[first-mcp|你的第一个 MCP]] 这个例子中，我们申明了三个函数，用作 mcp 的 tool，resource 和 prompt。在 OpenMCP 中启动它们非常简单，点击右上角的 OpenMCP 图标即可连接：
|
||||
|
||||
|
||||
|
||||
|
||||
如果登录完成后，如图显示连接成功，则代表当前已经成功启动并连接 mcp 服务器。
|
||||
|
||||
|
||||
|
||||
## STDIO 连接的启动
|
||||
|
||||
对于 STDIO 为连接选项的开发方案，我们提供了一键式的快速启动，您不需要额外启动 mcp 的进程。OpenMCP 会自动连接和销毁。
|
||||
|
||||
目前支持的编程语言和它们对应的启动参数为：
|
||||
|
||||
|语言|连接参数|启动目录|
|
||||
|:-|:-|:-|
|
||||
|python|uv run mcp run $\{file\} | 往上追溯，第一个找到的 pyproject.toml 的目录|
|
||||
|nodejs|node $\{file\}| 往上追溯，第一个找到的 package.json 的目录|
|
||||
|go|go run $\{file\}| 往上追溯，第一个找到的 go.mod 的目录|
|
||||
|
||||
## SSE & Streamable HTTP 连接的启动
|
||||
|
||||
对于 SSE 和 Streamable HTTP 这两种远程连接的方式，由于我们并不知道您到底在哪个端口启动的服务器（因为你有可能把启动的 host 和 port 写在不可见的配置文件里或者写在环境变量里），因此，对于远程连接的情况，我们不支持自动创建服务器，您需要手动配置启动选项。
|
||||
|
||||
点击 VLE 左侧插件栏目的 OpenMCP，在 「MCP 连接（工作区）」 视图中，点击 + ，就可以创建一个新的连接。
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
选择你需要的通信方式。
|
||||
|
||||
|
||||
|
||||
输入MCP Server的地址。
|
||||
|
||||
|
||||
|
||||
:::info
|
||||
需要注意的是，不同的通信方式一般使用不同endpoint，目前的MCP server大多遵循下面的原则：
|
||||
|
||||
如果是以 SSE 启动，那么默认使用 /sse 作为endpoint，比如 http://localhost:8001/sse
|
||||
|
||||
如果是以 Streamable Http 启动，那么默认使用 /mcp 作为endpoint，比如 http://localhost:8001/mcp
|
||||
|
||||
当然，允许MCP Server使用两个不同的endpoint同时支持两种连接方式，这对于想要迁移到Streamable Http但短时间又不能放弃SSE的情况特别有效
|
||||
:::
|
||||
|
||||
## openmcp 插件的控制面板
|
||||
|
||||
在 VLE 的左侧可以找到 openmcp 的图标，点击后就是 openmcp 的控制面板。
|
||||
|
||||
|
||||
|
||||
当前工作区曾经连接过的 mcp 服务器会出现在这里，这是因为 openmcp 默认将工作区启动的 mcp 的连接信息存储在了 `.openmcp/tabs.{server-name}.json` 中，其中 `{server-name}` 就是 mcp 服务器连接成功的服务器名称。
|
||||
|
||||
:::warning
|
||||
注意，同一个项目中，你不应该有两个名字完全相同的 mcp 服务器，这会导致 `.openmcp/tabs.{server-name}.json` 连接信息存储冲突，发生未知错误。
|
||||
:::
|
||||
|
||||
如果你想要在任意工作区都能使用同一个 mcp 服务器，可以考虑在「安装的 MCP 服务器」中添加成熟耐用的 mcp 服务器，这个位置添加的 mcp 服务器全局可用。
|
||||
|
||||
在「入门与帮助」中，我们准备了一些可供入门的参考资料，还请阁下善加利用。
|
||||
68
en/plugin-tutorial/usage/debug.md
Normal file
68
en/plugin-tutorial/usage/debug.md
Normal file
@ -0,0 +1,68 @@
|
||||
# 调试 tools, resources 和 prompts
|
||||
|
||||
## 标签页
|
||||
|
||||
openmcp 以标签页作为调试项目的最小单元，点击栏目中的 + 可以创建新的标签页。OpenMCP 的 tools, resources 和 prompts 的基本使用与 Inspector 差不多，但是 OpenMCP 会自动帮您完成左侧资源列表的初始化，Inspector 中这一步需要手动完成。
|
||||
|
||||
## 调试内容的自动保存
|
||||
|
||||
openmcp 具备自动保存测试结果的功能。如下的行为会触发 openmcp 对标签页及其内容进行保存：
|
||||
|
||||
- 创建标签页，并选择一个有效的调试项目
|
||||
- 在调试页进行调试行为（选择工具，执行工具，询问大模型等）
|
||||
|
||||
当前 mcp 项目的测试数据会被保存在 `.openmcp/tabs.{server-name}.json` 中，其中 `{server-name}` 就是 mcp 服务器连接成功的服务器名称。
|
||||
|
||||
:::warning
|
||||
注意，同一个项目中，你不应该有两个名字完全相同的 mcp 服务器，这会导致 `.openmcp/tabs.{server-name}.json` 连接信息存储冲突，发生未知错误。
|
||||
:::
|
||||
|
||||
## 快速调试
|
||||
|
||||
在我们调试的过程中，难免会出现大模型回答得不好，而且这是因为某个工具出错导致的，为了快速定位是不是工具的问题，可以点击下方的小飞机图标
|
||||
|
||||
|
||||
|
||||
点击后，OpenMCP 会一个新的测试 tool 的项目，并自动把当时大模型使用的参数自动填充到右侧的表单中：
|
||||
|
||||
|
||||
|
||||
你要做的，只是点击运行来确定或者排除一个错误选项。
|
||||
|
||||
## pydantic 支持
|
||||
|
||||
使用 python 的 fastmcp 进行 tool 的创建时，你有两种方法来申明接口的类型，一种是通过 python 默认的 typing 库来申明复杂数据结构，或者通过 pydantic 来申明一个复杂的变量，下面是一个例子：
|
||||
|
||||
```python
|
||||
from mcp.server.fastmcp import FastMCP
|
||||
from pydantic import BaseModel, Field
|
||||
from typing import Optional, Union, List, NamedTuple
|
||||
|
||||
mcp = FastMCP('锦恢的 MCP Server', version="11.45.14")
|
||||
|
||||
class PathParams(BaseModel):
|
||||
start: str
|
||||
end: str
|
||||
|
||||
@mcp.tool(name="test",description="用来测试")
|
||||
def test(
|
||||
params: PathParams,
|
||||
test1: str,
|
||||
test2: Union[str, List[str]] = Field("", description="测试参数2"),
|
||||
test3: Optional[str] = Field(None, description="测试参数3")
|
||||
):
|
||||
return [test1, test2, test3, params]
|
||||
```
|
||||
|
||||
由于我们对这两种类型的申明方式实现了内部的转换，所以 openmcp 都是支持的。值得一提的是，如果你申明的变量是一个对象，比如上面的 `PathParams`，那么 openmcp 的 tool 调试窗口会生成一个「对象输入框」，这个输入框支持基本的格式检查和自动补全：
|
||||
|
||||
|
||||
|
||||
:::info 什么是对象？
|
||||
这里的「对象」是 javascript 中的概念，它指的是可被序列化的数据类型中，除去基本数据类型后，剩下的那部分。比如 { "name": "helloworld" } 就是一个对象。对象在 python 中更加类似于一个 dict 或者 namedTuple。
|
||||
:::
|
||||
|
||||
:::warning
|
||||
虽然 openmcp 已经做到了尽可能多情况的支持，但是生产场景中，我们仍然不建议您将 mcp tool 的参数定义成对象，尽可能定义成简单数据类型也能更好提高大模型进行工具调用时的稳定性。
|
||||
:::
|
||||
|
||||
44
en/plugin-tutorial/usage/distribute-result.md
Normal file
44
en/plugin-tutorial/usage/distribute-result.md
Normal file
@ -0,0 +1,44 @@
|
||||
# 分发您的实验结果
|
||||
|
||||
## 标签页恢复
|
||||
|
||||
openmcp 默认会实时保存您的实验结果，每一个在工作区开启的服务器默认会将结果存储在 `.openmcp/tabs.{server-name}.json` 中，其中 `{server-name}` 就是 mcp 服务器连接成功的服务器名称。
|
||||
|
||||
请确保您的 `.gitignore` 文件中没有包含匹配到 .openmcp 文件夹的规则。这样，当您通过 git 提交你的代码，对 agent 的代码进行管理时，当你在别的电脑上 clone 或者他人 clone 你的项目时，就能快速恢复你上一次的实验内容，继续进行实验或者开发调试。
|
||||
|
||||
## 连接恢复
|
||||
|
||||
每一个 mcp 服务器的连接信息会被保存在 `.openmcp/connection.json` 中，下面是一个例子：
|
||||
|
||||
```json
|
||||
{
|
||||
"items": [
|
||||
[
|
||||
{
|
||||
"connectionType": "STDIO",
|
||||
"command": "mcp",
|
||||
"args": [
|
||||
"run",
|
||||
"main.py"
|
||||
],
|
||||
"url": "",
|
||||
"cwd": "{workspace}/simple-mcp",
|
||||
"oauth": "",
|
||||
"clientName": "openmcp.connect.STDIO",
|
||||
"clientVersion": "0.0.1",
|
||||
"env": {},
|
||||
"serverInfo": {
|
||||
"name": "锦恢的 MCP Server",
|
||||
"version": "1.9.2"
|
||||
},
|
||||
"filePath": "{workspace}/simple-mcp/main.py",
|
||||
"name": "锦恢的 MCP Server",
|
||||
"version": "1.9.2"
|
||||
}
|
||||
]
|
||||
]
|
||||
}
|
||||
```
|
||||
|
||||
|
||||
当您打开左侧的控制面板或者打开一个过去打开过的 mcp 服务器时， mcp 默认会根据上面的信息来获取工作区的服务器列表或者尝试进行自动连接。如果 openmcp 在连接 mcp 时发生了初始化错误或者保存错误，除了向 openmcp 官方求助外，您还可以尝试手动管理 `.openmcp/connection.json` 文件。
|
||||
BIN
en/plugin-tutorial/usage/images/add-connection.png
Normal file
BIN
en/plugin-tutorial/usage/images/add-connection.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 56 KiB |
BIN
en/plugin-tutorial/usage/images/add-new-mcp.png
Normal file
BIN
en/plugin-tutorial/usage/images/add-new-mcp.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 99 KiB |
BIN
en/plugin-tutorial/usage/images/change-color.png
Normal file
BIN
en/plugin-tutorial/usage/images/change-color.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 177 KiB |
BIN
en/plugin-tutorial/usage/images/connect-simple.png
Normal file
BIN
en/plugin-tutorial/usage/images/connect-simple.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 511 KiB |
BIN
en/plugin-tutorial/usage/images/connect-sse.png
Normal file
BIN
en/plugin-tutorial/usage/images/connect-sse.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 16 KiB |
BIN
en/plugin-tutorial/usage/images/connect-success.png
Normal file
BIN
en/plugin-tutorial/usage/images/connect-success.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 394 KiB |
BIN
en/plugin-tutorial/usage/images/drag-to-fill.png
Normal file
BIN
en/plugin-tutorial/usage/images/drag-to-fill.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 411 KiB |
BIN
en/plugin-tutorial/usage/images/guide.png
Normal file
BIN
en/plugin-tutorial/usage/images/guide.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 428 KiB |
BIN
en/plugin-tutorial/usage/images/llm-fast-debug-result.png
Normal file
BIN
en/plugin-tutorial/usage/images/llm-fast-debug-result.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 204 KiB |
BIN
en/plugin-tutorial/usage/images/llm-fast-debug.png
Normal file
BIN
en/plugin-tutorial/usage/images/llm-fast-debug.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 106 KiB |
BIN
en/plugin-tutorial/usage/images/oauth-github-ak.png
Normal file
BIN
en/plugin-tutorial/usage/images/oauth-github-ak.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 105 KiB |
BIN
en/plugin-tutorial/usage/images/oauth-github-new-application.png
Normal file
BIN
en/plugin-tutorial/usage/images/oauth-github-new-application.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 91 KiB |
BIN
en/plugin-tutorial/usage/images/oauth-github-success.png
Normal file
BIN
en/plugin-tutorial/usage/images/oauth-github-success.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 17 KiB |
BIN
en/plugin-tutorial/usage/images/oauth-github-tool.png
Normal file
BIN
en/plugin-tutorial/usage/images/oauth-github-tool.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 221 KiB |
BIN
en/plugin-tutorial/usage/images/object-input.png
Normal file
BIN
en/plugin-tutorial/usage/images/object-input.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 174 KiB |
BIN
en/plugin-tutorial/usage/images/one-dark-pro.png
Normal file
BIN
en/plugin-tutorial/usage/images/one-dark-pro.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 502 KiB |
BIN
en/plugin-tutorial/usage/images/openmcp-control-panel.png
Normal file
BIN
en/plugin-tutorial/usage/images/openmcp-control-panel.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 174 KiB |
BIN
en/plugin-tutorial/usage/images/parallel-tool-call.png
Normal file
BIN
en/plugin-tutorial/usage/images/parallel-tool-call.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 134 KiB |
BIN
en/plugin-tutorial/usage/images/prompt.png
Normal file
BIN
en/plugin-tutorial/usage/images/prompt.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 48 KiB |
BIN
en/plugin-tutorial/usage/images/resource.png
Normal file
BIN
en/plugin-tutorial/usage/images/resource.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 591 KiB |
BIN
en/plugin-tutorial/usage/images/select-server-type.png
Normal file
BIN
en/plugin-tutorial/usage/images/select-server-type.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 13 KiB |
BIN
en/plugin-tutorial/usage/images/setting-api-edit-1.png
Normal file
BIN
en/plugin-tutorial/usage/images/setting-api-edit-1.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 92 KiB |
BIN
en/plugin-tutorial/usage/images/setting-api-edit.png
Normal file
BIN
en/plugin-tutorial/usage/images/setting-api-edit.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 88 KiB |
BIN
en/plugin-tutorial/usage/images/setting-api-test.png
Normal file
BIN
en/plugin-tutorial/usage/images/setting-api-test.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 125 KiB |
BIN
en/plugin-tutorial/usage/images/setting-api.png
Normal file
BIN
en/plugin-tutorial/usage/images/setting-api.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 180 KiB |
BIN
en/plugin-tutorial/usage/images/setting-update-models.png
Normal file
BIN
en/plugin-tutorial/usage/images/setting-update-models.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 166 KiB |
BIN
en/plugin-tutorial/usage/images/system-prompt.png
Normal file
BIN
en/plugin-tutorial/usage/images/system-prompt.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 326 KiB |
BIN
en/plugin-tutorial/usage/images/trae-blue.png
Normal file
BIN
en/plugin-tutorial/usage/images/trae-blue.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 544 KiB |
35
en/plugin-tutorial/usage/multi-server.md
Normal file
35
en/plugin-tutorial/usage/multi-server.md
Normal file
@ -0,0 +1,35 @@
|
||||
# 连接多个 MCP 服务器
|
||||
|
||||
openmcp 支持连接多个 MCP 服务器。
|
||||
|
||||
假设你现在想要实现一个可以自动查阅资料并且整理成 word 文档的 agent，你可以这样做：
|
||||
|
||||
1. 找到能进行网络搜索的 mcp：[crawl4ai mcp](https://github.com/LSTM-Kirigaya/openmcp-tutorial/tree/main/crawl4ai-mcp)
|
||||
2. 找到能进行 word 操作的 mcp：[Office-Word-MCP-Server](https://github.com/GongRzhe/Office-Word-MCP-Server)
|
||||
3. 在 openmcp 中把它们组合起来。
|
||||
4. 自动完成你的任务！
|
||||
|
||||
假设，我们已经连接了第一个 mcp，也就是 crawl4ai mcp，我们可以添加额外的 mcp 服务器：
|
||||
|
||||
|
||||
|
||||
## 添加方法一：拖拽
|
||||
|
||||
直接把需要加入的 mcp 服务器的文件，按住 shift 点击拖拽进入 openmcp 界面就能自动完成参数的填充。
|
||||
|
||||
|
||||
|
||||
:::warning
|
||||
自动填充的命令不一定总是准确的，在 [STDIO 连接的启动](http://localhost:5173/openmcp/plugin-tutorial/usage/connect-mcp.html#stdio-%E8%BF%9E%E6%8E%A5%E7%9A%84%E5%90%AF%E5%8A%A8) 中我们说过这一点。具体的连接方法请阅读 [附录：关于 uv 启动 mcp 你必须知道的](http://localhost:5173/openmcp/plugin-tutorial/quick-start/first-mcp.html#%E9%99%84%E5%BD%95-%E5%85%B3%E4%BA%8E-uv-%E5%90%AF%E5%8A%A8-mcp-%E4%BD%A0%E5%BF%85%E9%A1%BB%E7%9F%A5%E9%81%93%E7%9A%84) 后自行判断。
|
||||
:::
|
||||
|
||||
## 添加方法二：手动填写参数
|
||||
|
||||
手动填写参数，没啥好说的。
|
||||
|
||||
|
||||
## 使用多服务器
|
||||
|
||||
多服务器连接后的使用和单服务器没有太大的区别，openmcp 内部会自动完成工具的调度和选择。唯一需要注意的是，多服务器的 tool name 一定不要重名，否则会出现冲突。
|
||||
|
||||
如果您认为 tool 重名有存在的必要性，请通过 [issue](https://github.com/LSTM-Kirigaya/openmcp-client/issues) 让我们知道您的场景和想法，根据讨论，我们会支持。
|
||||
77
en/plugin-tutorial/usage/sse-oauth2.md
Normal file
77
en/plugin-tutorial/usage/sse-oauth2.md
Normal file
@ -0,0 +1,77 @@
|
||||
# MCP Server的OAuth鉴权实现
|
||||
|
||||
在使用 **SSE** 或 **Streamable HTTP** 进行连接时，为增强安全性可为接口设计鉴权机制，MCP 官方推荐采用 OAuth 协议。下面以获取 GitHub 用户信息为例，演示如何通过 openmcp-client 完成带 OAuth 认证的接口调试。
|
||||
|
||||
|
||||
|
||||
## 1. 获取Github OAuth认证ID和secret
|
||||
|
||||
由于我们使用了Github用户信息相关API，需要先获取Github OAuth应用的Client ID和Client secret。
|
||||
|
||||
先进入[Github Developers](https://github.com/settings/developers)，点击`New OAuth App`新建一个OAuth APP，应用名称随便填，`Homepage URL`填写`http://localhost:8000`,`Authorization callback URL`填写`http://localhost:8000/github/callback`。然后点击`Register application`按钮，即可成功注册一个应用。
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
注册成功后，请记录`Client ID`，然后点击`Generate a new client secret`生成一个`secret`，注意secret仅在生成的时候可见。
|
||||
|
||||
## 2. 设置环境变量
|
||||
|
||||
在获取`Client ID`和`secret`之后，需要将其设置为环境变量：
|
||||
|
||||
|
||||
|
||||
::: code-group
|
||||
```bash [bash]
|
||||
export MCP_GITHUB_GITHUB_CLIENT_ID={{Client ID}}
|
||||
export MCP_GITHUB_GITHUB_CLIENT_SECRET={{secret}}
|
||||
```
|
||||
|
||||
```bash [PowerShell]
|
||||
$env:MCP_GITHUB_CLIENT_ID = "your_id"
|
||||
$env:MCP_GITHUB_CLIENT_SECRET = "your_secret"
|
||||
```
|
||||
|
||||
```bash [CMD]
|
||||
set MCP_GITHUB_GITHUB_CLIENT_ID={{Client ID}}
|
||||
set MCP_GITHUB_GITHUB_CLIENT_SECRET={{secret}}
|
||||
```
|
||||
:::
|
||||
|
||||
注意：cmd里面设置环境变量请不要加引号。
|
||||
|
||||
## 3. 克隆源码
|
||||
|
||||
接下来，我们需要部署带有OAuth认证的MCP服务器。可以参照[官方python案例](https://github.com/modelcontextprotocol/python-sdk/tree/main/examples/servers/simple-auth)进行。
|
||||
|
||||
需要先克隆官方python-sdk源码：
|
||||
|
||||
```bash
|
||||
git clone https://github.com/modelcontextprotocol/python-sdk/ # 克隆源码
|
||||
cd examples/servers/simple-auth # 进入对应的目录
|
||||
```
|
||||
|
||||
## 4. 启动MCP Server
|
||||
|
||||
先根据需要创建虚拟环境安装依赖，然后可以使用`uv`运行或者直接运行`python main.py`即可，注意需要先设置环境变量，不然启动会报错`2 validation errors for ServerSettings`。
|
||||
|
||||
## 5. 启动openmcp-client
|
||||
|
||||
接下来，你就可以使用openmcp-client连接刚刚启动的server了，不管是使用网页端还是VSCode均可。
|
||||
|
||||
点击加号添加连接，根据server代码中的`--transport`参数决定是SSE还是Streamable HTTP。如果是SSE，则URL填写`http://localhost:8000/sse`；如果是Streamable HTTP，则URL填写`http://localhost:8000/mcp`。认证签名无需填写。
|
||||
|
||||
接下来连接到当前server，此时会自动打开一个网页进行认证，首次打开需要点击认证，认证成功后该网页会自动关闭。
|
||||
|
||||
|
||||
|
||||
认证成功后，进入工具页面，应该能看到一个`get_user_profile`工具，点击使用就可以获取到你的Github个人信息了。
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
|
||||
72
en/plugin-tutorial/usage/test-with-llm.md
Normal file
72
en/plugin-tutorial/usage/test-with-llm.md
Normal file
@ -0,0 +1,72 @@
|
||||
# 用大模型测试您的 mcp
|
||||
|
||||
如果您完成了 [[connect-llm|连接 mcp 服务器]] 这一步，那么您就可以开始测试您的 mcp 了。
|
||||
|
||||
在 [[put-into-llm|扔进大模型里面测测好坏！]] 中，我们已经通过一个简单的例子来展示来如何使用大模型测试您的 mcp。因此，这篇文章更多是讲解不便在「快速开始」中赘述的细节。
|
||||
|
||||
|
||||
和大模型交互时，有一些参数可以选择，也就是输入框下面那一排按钮，我来简单介绍一下。
|
||||
|
||||
## 选择模型
|
||||
|
||||
顾名思义，你可以在这里切换你的模型。值得一提的是，openmcp 会以单条对话为粒度来记录每一条对话使用的模型。您可以利用这一特性来进行混合模型测试。
|
||||
|
||||
如果你没有找到你想要的模型，或是想要添加额外的模型，请移步 [[connect-llm|连接 mcp 服务器]] 来了解如何添加模型。
|
||||
|
||||
## 系统提示词
|
||||
|
||||
您可以在这里选择和添加系统提示词。
|
||||
|
||||
|
||||
|
||||
openmcp 默认将您的系统提示词保存在 `~/.openmcp/nedb/systemPrompt.db` 中。您可以通过 nedb 来进行反序列化和拷贝。
|
||||
|
||||
|
||||
## 提词
|
||||
|
||||
您可以利用该模块来调用 mcp 服务器提供的 prompt 功能，生成的 prompt 字段会作为富文本被插入您的对话中。
|
||||
|
||||
|
||||
|
||||
## 资源
|
||||
|
||||
您可以利用该模块来调用 mcp 服务器提供的 resource 功能，生成的 resource 字段会作为富文本被插入您的对话中。
|
||||
|
||||
|
||||
|
||||
:::warning openmcp 不负责 resource 的数据持久化！
|
||||
请注意！每次对话完成后 resource 是否会被保存到磁盘完全由 mcp server 作者决定，openmcp 不负责 resource 的数据持久化！如果您发现关闭 openmcp 再打开，resource 彩蛋为空，这不是 openmcp 的 bug，而是 mcp server 作者没有支持数据持久化！
|
||||
:::
|
||||
|
||||
|
||||
## 允许模型在单轮回复中调用多个工具
|
||||
|
||||
大模型在进行工具调用时，有时候会将在一次回复中要求调用多次工具，比如你想要同时获取三个网页的内容翻译，大模型可能会同时调用三次「网络搜索」工具（如果你提供了的话）。多次工具使用时，openmcp 会如此渲染调用执行过程：
|
||||
|
||||
|
||||
|
||||
openmcp 输入框的按钮中的「允许模型在单轮回复中调用多个工具」默认是点亮的。也就是允许大模型可以在一次回复中调用多次工具。
|
||||
|
||||
有的时候，我们希望命令一条条执行，就可以选择把这个按钮熄灭。
|
||||
|
||||
:::warning 协议兼容性警告
|
||||
有的厂商（比如 gemini）不一定严格支持了 openai 协议，对于不支持 「允许模型在单轮回复中调用多个工具」的厂商，openmcp 的后端会自动将该选项关闭。
|
||||
:::
|
||||
|
||||
|
||||
## 温度参数
|
||||
|
||||
温度参数越高，生成内容的随机性越强，对于通用大模型，个人建议参数为 0.6 ~ 0.7，会是一个适用于通用型任务的数值。OpenMCP 提供的默认值为 0.6。
|
||||
|
||||
## 上下文长度
|
||||
|
||||
上下文长度代表了大模型的最大上下文轮数，默认值为 20。举个例子，如果你和大模型对话产生了 40 轮数据（工具调用条数+你的问题数量+大模型回答的次数总共 40 个），那么下一次对话 openmcp 只会发送最后 20 条数据给大模型。
|
||||
|
||||
:::warning 上下文长度不要太小！
|
||||
我们强烈不推荐你将这个数值设置低于 20，因为大模型接受工具调用的结果需要和之前的调用请求一一对应。如果不对应，大模型会返回注入 400 这样的错误。遇到这样的错误，请从最初一句话重启或者新开一个「交互测试」。
|
||||
:::
|
||||
|
||||
## MCP 服务器超时
|
||||
|
||||
MCP 服务器默认超时时间为 30 秒，如果您的 mcp 服务器需要更长的时间才能完成任务，您可以通过「设置」「通用」来设置超时时间，单位为秒，该设置全局生效。
|
||||
|
||||
25
en/plugin-tutorial/usage/ui-color.md
Normal file
25
en/plugin-tutorial/usage/ui-color.md
Normal file
@ -0,0 +1,25 @@
|
||||
# UI 配色
|
||||
|
||||
## openmcp 的主题色随跟 vscode
|
||||
|
||||
openmcp 的主题颜色完全跟随 vscode，如果你想要更换 openmcp 的主题颜色，你只需要更换 vscode 的主题颜色即可。
|
||||
|
||||
比如当你把颜色切换为社区知名主题 One Dark Pro 时，openmcp 的表现：
|
||||
|
||||
|
||||
|
||||
|
||||
## 切换主题色
|
||||
|
||||
这里可以切换 openmcp 的主题色（默认是粉色）
|
||||
|
||||
|
||||
|
||||
|
||||
## Trae 的特殊支持
|
||||
|
||||
openmcp 对 trae 的默认主题色都有额外的支持。我们也鼓励我们的用户尝试 vscode，cursor，trae 等不同的 VLE 来获得最佳手感。
|
||||
|
||||
openmcp 官方文档大部分演示的例子都是基于 trae 的「深蓝」默认主题。
|
||||
|
||||
|
||||
Some files were not shown because too many files have changed in this diff Show More
Loading…
x
Reference in New Issue
Block a user