SourceSync.ai MCP服务器
](https://smithery.ai/server/@pbteja1998/sourcesyncai-mcp)
模型上下文协议(MCP)服务器实现 SourceSync.ai API该服务器允许AI模型通过标准化的接口与SourceSync.AI的知识管理平台进行交互。
特性
- 管理命名空间以组织知识
- 从各种来源(文本、网址、网站、外部服务)获取内容
- 检索、更新和管理存储在知识库中的文档
- 对知识库执行语义搜索和混合搜索
- 直接从解析的文本URL访问文档内容
- 管理与外部服务的连接
- 默认配置支持无缝AI集成
安装
使用npx运行
# Install and run with your API key and tenant ID
env SOURCESYNC_API_KEY=your_api_key npx -y sourcesyncai-mcp通过Smithery安装
通过以下方式自动安装克劳德桌面的sourcesyncai mcp 史密瑟里:
npx -y @smithery/cli install @pbteja1998/sourcesyncai-mcp --client claude手动安装
# Clone the repository
git clone https://github.com/yourusername/sourcesyncai-mcp.git
cd sourcesyncai-mcp
# Install dependencies
npm install
# Build the project
npm run build
# Run the server
node dist/index.js在游标上运行
要在游标中配置SourceSync.ai MCP,请执行以下操作:
- 打开光标设置
- 首选
Features > MCP Servers - 点击
+ Add New MCP Server - 输入以下内容:
- 姓名: sourcesyncai-mcp (或您喜欢的名字) - 类型: command - 命令: env SOURCESYNCAI_API_KEY=your-api-key npx -y sourcesyncai-mcp
添加后,您可以通过描述您的知识管理需求,使用具有Cursor ai功能的SourceSync.ai工具。
在风帆上跑步
将此添加到您的 ./codeium/windsurf/model_config.json:
{
"mcpServers": {
"sourcesyncai-mcp": {
"command": "npx",
"args": ["-y", "soucesyncai-mcp"],
"env": {
"SOURCESYNC_API_KEY": "your_api_key",
"SOURCESYNC_NAMESPACE_ID": "your_namespace_id",
"SOURCESYNC_TENANT_ID": "your_tenant_id"
}
}
}
}在Claude桌面上运行
要将此MCP服务器与Claude Desktop一起使用:
- 找到Claude Desktop配置文件:
- macOS: ~/Library/Application Support/Claude/claude_desktop_config.json - 视窗: %APPDATA%\Claude\claude_desktop_config.json - Linux: ~/.config/Claude/claude_desktop_config.json
- 编辑配置文件以添加SourceSync.ai MCP服务器:
{
"mcpServers": {
"sourcesyncai-mcp": {
"command": "npx",
"args": ["-y", "sourcesyncai-mcp"],
"env": {
"SOURCESYNC_API_KEY": "your_api_key",
"SOURCESYNC_NAMESPACE_ID": "your_namespace_id",
"SOURCESYNC_TENANT_ID": "your_tenant_id"
}
}
}
}- 保存配置文件并重新启动Claude Desktop
配置
环境变量
必需
SOURCESYNC_API_KEY:您的SourceSync.ai API密钥(必需)
可选的
SOURCESYNC_NAMESPACE_ID:用于操作的默认命名空间IDSOURCESYNC_TENANT_ID:您的租户ID(可选)
配置示例
具有默认值的基本配置:
export SOURCESYNC_API_KEY=your_api_key
export SOURCESYNC_TENANT_ID=your_tenant_id
export SOURCESYNC_NAMESPACE_ID=your_namespace_id可用工具
认证
validate_api_key:验证SourceSync.ai API密钥
{
"name": "validate_api_key",
"arguments": {}
}命名空间
create_namespace:创建新命名空间list_namespaces:列出所有命名空间get_namespace:获取特定命名空间的详细信息update_namespace:更新命名空间delete_namespace:删除命名空间
{
"name": "create_namespace",
"arguments": {
"name": "my-namespace",
"fileStorageConfig": {
"provider": "S3_COMPATIBLE",
"config": {
"endpoint": "s3.amazonaws.com",
"accessKey": "your_access_key",
"secretKey": "your_secret_key",
"bucket": "your_bucket",
"region": "us-east-1"
}
},
"vectorStorageConfig": {
"provider": "PINECONE",
"config": {
"apiKey": "your_pinecone_api_key",
"environment": "your_environment",
"index": "your_index"
}
},
"embeddingModelConfig": {
"provider": "OPENAI",
"config": {
"apiKey": "your_openai_api_key",
"model": "text-embedding-3-small"
}
},
"tenantId": "tenant_XXX"
}
}{
"name": "list_namespaces",
"arguments": {
"tenantId": "tenant_XXX"
}
}{
"name": "get_namespace",
"arguments": {
"namespaceId": "namespace_XXX",
"tenantId": "tenant_XXX"
}
}{
"name": "update_namespace",
"arguments": {
"namespaceId": "namespace_XXX",
"tenantId": "tenant_XXX",
"name": "updated-namespace-name"
}
}{
"name": "delete_namespace",
"arguments": {
"namespaceId": "namespace_XXX",
"tenantId": "tenant_XXX"
}
}数据摄入
ingest_text:摄入文本内容ingest_urls:从URL中获取内容ingest_sitemap:从站点地图中获取内容ingest_website:从网站摄取内容ingest_notion:从Notion摄取内容ingest_google_drive:从Google云端硬盘获取内容ingest_dropbox:从Dropbox获取内容ingest_onedrive:从OneDrive摄取内容ingest_box:从Box中摄取内容get_ingest_job_run_status:获取摄取作业运行的状态
{
"name": "ingest_text",
"arguments": {
"namespaceId": "your_namespace_id",
"ingestConfig": {
"source": "TEXT",
"config": {
"name": "example-document",
"text": "This is an example document for ingestion.",
"metadata": {
"category": "example",
"author": "AI Assistant"
}
}
},
"tenantId": "tenant_XXX"
}
}{
"name": "ingest_urls",
"arguments": {
"namespaceId": "your_namespace_id",
"ingestConfig": {
"source": "URLS",
"config": {
"urls": ["https://example.com/page1", "https://example.com/page2"],
"metadata": {
"source": "web",
"category": "documentation"
}
}
},
"tenantId": "tenant_XXX"
}
}{
"name": "ingest_sitemap",
"arguments": {
"namespaceId": "your_namespace_id",
"ingestConfig": {
"source": "SITEMAP",
"config": {
"url": "https://example.com/sitemap.xml",
"metadata": {
"source": "sitemap",
"website": "example.com"
}
}
},
"tenantId": "tenant_XXX"
}
}{
"name": "ingest_website",
"arguments": {
"namespaceId": "your_namespace_id",
"ingestConfig": {
"source": "WEBSITE",
"config": {
"url": "https://example.com",
"maxDepth": 3,
"maxPages": 100,
"metadata": {
"source": "website",
"domain": "example.com"
}
}
},
"tenantId": "tenant_XXX"
}
}{
"name": "ingest_notion",
"arguments": {
"namespaceId": "your_namespace_id",
"ingestConfig": {
"source": "NOTION",
"config": {
"connectionId": "your_notion_connection_id",
"metadata": {
"source": "notion",
"workspace": "My Workspace"
}
}
},
"tenantId": "your_tenant_id"
}
}{
"name": "ingest_google_drive",
"arguments": {
"namespaceId": "your_namespace_id",
"ingestConfig": {
"source": "GOOGLE_DRIVE",
"config": {
"connectionId": "connection_XXX",
"metadata": {
"source": "google_drive",
"owner": "user@example.com"
}
}
},
"tenantId": "tenant_XXX"
}
}{
"name": "ingest_dropbox",
"arguments": {
"namespaceId": "your_namespace_id",
"ingestConfig": {
"source": "DROPBOX",
"config": {
"connectionId": "connection_XXX",
"metadata": {
"source": "dropbox",
"account": "user@example.com"
}
}
},
"tenantId": "tenant_XXX"
}
}{
"name": "ingest_onedrive",
"arguments": {
"namespaceId": "your_namespace_id",
"ingestConfig": {
"source": "ONEDRIVE",
"config": {
"connectionId": "connection_XXX",
"metadata": {
"source": "onedrive",
"account": "user@example.com"
}
}
},
"tenantId": "tenant_XXX"
}
}{
"name": "ingest_box",
"arguments": {
"namespaceId": "your_namespace_id",
"ingestConfig": {
"source": "BOX",
"config": {
"connectionId": "connection_XXX",
"metadata": {
"source": "box",
"owner": "user@example.com"
}
}
},
"tenantId": "tenant_XXX"
}
}{
"name": "get_ingest_job_run_status",
"arguments": {
"namespaceId": "your_namespace_id",
"ingestJobRunId": "ingest_job_run_XXX",
"tenantId": "tenant_XXX"
}
}文件
getDocuments:使用可选筛选器检索文档updateDocuments:更新文档元数据deleteDocuments:删除文档resyncDocuments:重新同步文档fetchUrlContent:从文档URL获取文本内容
{
"name": "getDocuments",
"arguments": {
"namespaceId": "namespace_XXX",
"tenantId": "tenant_XXX",
"filterConfig": {
"documentTypes": ["PDF"]
},
"includeConfig": {
"parsedTextFileUrl": true
}
}
}{
"name": "updateDocuments",
"arguments": {
"namespaceId": "namespace_XXX",
"tenantId": "tenant_XXX",
"documentIds": ["doc_XXX", "doc_YYY"],
"filterConfig": {
"documentIds": ["doc_XXX", "doc_YYY"]
},
"data": {
"metadata": {
"status": "reviewed",
"category": "technical"
}
}
}
}{
"name": "deleteDocuments",
"arguments": {
"namespaceId": "namespace_XXX",
"tenantId": "tenant_XXX",
"documentIds": ["doc_XXX", "doc_YYY"],
"filterConfig": {
"documentIds": ["doc_XXX", "doc_YYY"]
}
}
}{
"name": "resyncDocuments",
"arguments": {
"namespaceId": "namespace_XXX",
"tenantId": "tenant_XXX",
"documentIds": ["doc_XXX", "doc_YYY"],
"filterConfig": {
"documentIds": ["doc_XXX", "doc_YYY"]
}
}
}{
"name": "fetchUrlContent",
"arguments": {
"url": "https://api.sourcesync.ai/v1/documents/doc_XXX/content?format=text",
"apiKey": "your_api_key",
"tenantId": "tenant_XXX"
}
}搜索
semantic_search:执行语义搜索hybrid_search:执行混合搜索(语义+关键字)
{
"name": "semantic_search",
"arguments": {
"namespaceId": "your_namespace_id",
"query": "example document",
"topK": 5,
"tenantId": "tenant_XXX"
}
}{
"name": "hybrid_search",
"arguments": {
"namespaceId": "your_namespace_id",
"query": "example document",
"topK": 5,
"tenantId": "tenant_XXX",
"hybridConfig": {
"semanticWeight": 0.7,
"keywordWeight": 0.3
}
}
}连接
create_connection:创建与外部服务的新连接list_connections:列出所有连接get_connection:获取特定连接的详细信息update_connection:更新连接revoke_connection:撤消连接
{
"name": "create_connection",
"arguments": {
"tenantId": "tenant_XXX",
"namespaceId": "namespace_XXX",
"name": "My Connection",
"connector": "GOOGLE_DRIVE",
"clientRedirectUrl": "https://your-app.com/callback"
}
}{
"name": "list_connections",
"arguments": {
"tenantId": "tenant_XXX",
"namespaceId": "namespace_XXX"
}
}{
"name": "get_connection",
"arguments": {
"tenantId": "tenant_XXX",
"namespaceId": "namespace_XXX",
"connectionId": "connection_XXX"
}
}{
"name": "update_connection",
"arguments": {
"tenantId": "tenant_XXX",
"namespaceId": "namespace_XXX",
"connectionId": "connection_XXX",
"name": "Updated Connection Name",
"clientRedirectUrl": "https://your-app.com/updated-callback"
}
}{
"name": "revoke_connection",
"arguments": {
"tenantId": "tenant_XXX",
"namespaceId": "namespace_XXX",
"connectionId": "connection_XXX"
}
}示例提示
以下是配置MCP服务器后可以与Claude或Cursor一起使用的一些示例提示:
- “在我的SourceSync知识库中搜索有关机器学习的信息。”
- “将此文章纳入我的SourceSync知识库:\[URL\]”
- “在SourceSync中为我的项目文档创建一个新的命名空间。”
- “列出我的SourceSync命名空间中的所有文档。”
- “从我的SourceSync命名空间获取文档\[document_id\]的文本内容。”
故障排除
连接问题
如果在连接SourceSync.ai MCP服务器时遇到问题:
- 验证路径:确保配置中的所有路径都是绝对路径,而不是相对路径。
- 检查权限:确保服务器文件具有执行权限(
chmod +x dist/index.js).
- 启用开发人员模式:在Claude Desktop中,启用开发人员模式并检查MCP日志文件。
- 测试服务器:直接从命令行运行服务器:
node /path/to/sourcesyncai-mcp/dist/index.js- 重新启动AI客户端:更改后,完全重新启动Claude Desktop或Cursor。
- 检查环境变量:确保所有必需的环境变量都已正确设置。
调试日志记录
有关详细的日志记录,请添加DEBUG环境变量:
发展
项目结构
src/index.ts:主要入口点和服务器设置src/schemas.ts:所有工具的模式定义src/sourcesync.ts:用于与SourceSync.ai API交互的客户端src/sourcesync.types.ts:TypeScript类型定义
建造和测试
# Build the project
npm run build
# Run tests
npm test许可证
麻省理工学院
链接
文档内容检索工作流程:
- 首先,使用
getDocuments随着includeConfig.parsedTextFileUrl: true获取包含其内容URL的文档 - 从文档响应中提取URL
- 使用
fetchUrlContent以检索实际内容:
{
"name": "fetchUrlContent",
"arguments": {
"url": "https://example.com"
}
}