MCP - MCP服务，MCP服务器，MCP教程

基本能力

产品定位

MCP（Model Context Protocol）是一个实验性的协议，用于与Algolia API进行交互。该项目提供了一个Algolia MCP服务器的原型，允许用户通过MCP协议与Algolia的搜索服务进行交互。

核心功能

• 与Algolia API交互
• 支持搜索、添加、更新和配置索引
• 支持通过环境变量配置Algolia的APP ID、索引名称和API密钥
• 支持与Ollama等本地模型一起使用

适用场景

• 实验性项目开发
• 本地开发环境
• 与Algolia搜索服务交互的测试

工具列表

• MCP Inspector：用于检查MCP功能并手动运行它们
• mcphost：用于本地运行MCP服务器并与Ollama等模型一起使用

常见问题解答

• 安装后可以做什么？
• 搜索索引中的产品
• 添加JSON对象到索引
• 更新索引的可搜索属性
• 配置索引的排名规则
• 哪里可以了解更多关于Algolia MCP服务器的信息？
• 可以参考这篇博客文章
• 资源模板和根目前不支持
• 这是一个已知问题，可能尚未正式发布

使用教程

使用依赖

• Go：需要安装Go语言环境
  shell
$ go install https://go.dev/doc/install

安装教程

1. 克隆仓库并构建MCP服务器
   shell
$ git clone git@github.com:algolia/mcp.git
$ cd mcp/cmd/mcp
$ go build
2. 获取构建后的服务器二进制文件路径
   shell
$ pwd
/path/to/the/repo/cmd/mcp
3. 更新Claude desktop设置，添加Algolia服务器定义
   json
{
"mcpServers": {
"algolia": {
"command": "/path/to/the/repo/cmd/mcp/mcp",
"env": {
"ALGOLIA_APP_ID": "<APP_ID>",
"ALGOLIA_INDEX_NAME": "<INDEX_NAME>",
"ALGOLIA_API_KEY": "<API_KEY>",
"ALGOLIA_WRITE_API_KEY": "<ADMIN_API_KEY>"
}
}
}
}
4. 重启Claude desktop

调试方式

1. 设置环境变量
   shell
$ export ALGOLIA_APP_ID=""
$ export ALGOLIA_INDEX_NAME=""
$ export ALGOLIA_API_KEY=""
$ export ALGOLIA_WRITE_API_KEY=""
2. 进入服务器目录并重新构建（如果需要）
   shell
$ cd cmd/mcp
$ go build
3. 运行MCP Inspector
   shell
$ npx @modelcontextprotocol/inspector ./mcp

与Ollama一起使用

1. 创建配置文件
   json
{
"mcpServers": {
"algolia": {
"command": "/path/to/the/repo/cmd/mcp/mcp",
"env": {
"ALGOLIA_APP_ID": "<APP_ID>",
"ALGOLIA_INDEX_NAME": "<INDEX_NAME>",
"ALGOLIA_API_KEY": "<API_KEY>"
}
}
}
}
2. 运行mcphost
   shell
$ go run github.com/mark3labs/mcphost@latest --config ~/mcp.json -m ollama:qwen2.5:3b